top of page

Getting started

From the Welcome screen to your first plan. Each step names the button and its shortcut on the Mac.

1

Install

Get ArchitectBuddies™ from the App Store. It runs on iPad with iPadOS 18 or later and on Macs with Apple silicon.

2

Choose a notation

On the Welcome screen, pick a notation card and tap Create First Canvas. Or tap Import / Load Model to open a file.

The Welcome screen

3

Add elements

Open the Element Selector (⌘E), slide a row to the left and tap Add. Tap the canvas to close the selector.

The Element Selector

4

Connect them

Drag one element over another until its edge turns red, and pause. Pick a relationship in the Connector Selector.

The Connector Selector

5

Arrange the canvas

Tap the canvas title to switch canvases, touch and hold it to choose a diagram type. Grid (⌘G), magnify and undo (⌘Z) are along the top.

6

Set up AI (Pro)

Open the chat with the Architect Buddies™ button (⌘T), then Chat Settings. Decide on Data Security, choose Single Agent (One Buddy) or Team (of Buddies), then select a provider and model. For cloud AI services, paste in the API key obtained from your selected provider.

Chat Settings

7

Pick a starting point

An empty chat offers six starting points. ‘Model with One Buddy’ is the quickest first try.

The chat front door

8

Save your model

Save / Export (⌘S) writes a .abmodel bundle and an exchange file for each notation you used.

Running AI in the cloud

Get an API key

Create an account with OpenAI, Anthropic, Google AI Studio, xAI or AI/ML API and generate an API key. Cloud models give the Buddies the best results.

Get an API key →

Add it to the app

Open Chat Settings, choose the provider, paste in your key and pick a model. Your model is only sent to the provider you choose. Never share your key with anyone, including us.

Running AI locally

Ollama on your network

Install Ollama on a computer on the same network, choose Ollama in Chat Settings and allow local network access when your iPad asks. Nothing leaves your network.

Set up Ollama →

On the device

Choose the on-device provider and download a model in Chat Settings. Devices with 16 GB of memory or more are recommended. Smaller models are typically not as capable and reliable as larger models.

Set up on-device AI →

Stuck?

In the app, Help (⌘?) → What’s this? explains any control you tap. Or read the help pages here.

Orange-to-blue gradient divider line
ArchitectBuddies app icon

ArchitectBuddies™

Enterprise, systems and software architecture for iPad and Mac.

ArchiMate is a registered trademark of The Open Group in the United States and other countries.

OMG, SysML and UML are registered trademarks of Object Management Group, Inc. in the United States and/or other countries.

Apple, iPad, Mac and App Store are trademarks of Apple Inc., registered in the U.S. and other countries and regions.

The Arcadia-aligned planner is an independent implementation of the publicly described Arcadia method and is not affiliated with or endorsed by its originators.

© 2026 Hytsioaboa Software Limited. ArchitectBuddies™ and HytsioStudio are trading names of Hytsioaboa Software Limited. Registered in England and Wales, Company No. 16784431. Registered Office: 1 Pastoral Road, Bristol, BS35 1BG.

bottom of page