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, and every app uses them. Until you have one, the launcher shows a note that points here; Open API connections on it takes you straight to the tab.

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.

API connections show a provider logo when one is available.

For a model missing from a provider's catalog, edit its connection and click + Add model under Custom models. Enter its exact model ID, context window and maximum output tokens, then save. Added models appear alongside the provider catalog in every app. To remove one, click its remove button and save. You can also override limits for an existing ID. Custom endpoints use Manual list instead.

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, the one you opened last at the top. 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>