First start

The first time Chrysalis starts, it gives you a one-time setup link. Everything after that happens in the browser.

#Create your account

1. Chrysalis opens your browser at its setup address. If it did not, copy the link that starts with http:// and contains #setup= from the window where Chrysalis started.
2. Pick a username and password. This first account is the admin: it can change server settings and add more people.
3. The setup link works once. After that, the sign-in screen lists the accounts on this server.

#Connect a model

Chrysalis talks to AI models through connections you add once:

1. Open Settings, then API connections.
2. Click Add connection and choose a provider. Providers that need more than a key walk you through the extra steps.
3. Paste the key. It is stored on the server and never sent to your browser or to apps.

A model running on your own computer works too: pick it from the Local model group and give the address of its server. On another computer, use that computer's network address instead of localhost.

#Pick your apps

With no apps installed, the launcher shows a welcome screen with the official apps from the Store. Pick the ones you want, or skip and open the Store later. Want to roleplay? Pick Roleplay.

#The launcher

The launcher is the Where to? page every new tab starts on:

• System holds the Agent, which builds and changes your apps.
• Your apps lists what is installed. Select one to see its files, check for updates, export it, or launch it.
• Add has the Store, New app and Import app.

Apps open in tabs, so you can keep several side by side.

#More people

The admin can add accounts in Settings > Users. Every account gets its own apps, chats, agent and model connections; nobody sees anyone else's.

#Forgot a password

Stop Chrysalis, then run this in the program's folder (on Docker, inside the container):

chrysalis reset-password <username>