Creating Bots

Bots (also called profiles) are the core unit of AI Supreme Council. Each bot is a named configuration that ties together a provider, model, system prompt, generation parameters, and persona. There are two types:

• Individual profiles -- single-model configurations (1 member). These are the most common type, used for direct conversation with one AI model.
• Councils -- multi-model configurations (2+ members). These orchestrate multiple AI models in structured deliberation. See Councils for details.

Creating via the Setup Wizard

On your first visit, the setup wizard guides you through creating your first bot. The wizard offers two paths:

Single Profile Path

1. Choose "Single AI Profile" on the path selection screen
2. Pick a model from the registry -- cards show provider, pricing, context window, and capabilities. Use the search bar or filter by provider.
3. Enter your API key -- the wizard tests the connection immediately. If you chose a free model (Gemini Flash, OpenRouter :free models), an API key is still required but no charges apply.
4. Name your bot and pick an icon from the emoji selector
5. Done -- your profile is created and ready for chat

Cluster (Council) Path

1. Choose "Multi-Model Council" on the path selection screen
2. Select 2+ models from the registry using checkboxes. The wizard offers preset council templates (e.g., "Research Team" with free models) or you can pick custom models.
3. Enter API keys for each provider involved. If all selected models are free, this step is skipped.
4. Configure council settings -- name, icon, deliberation style (council, compare, arena, etc.), and member summary
5. Done -- your council is created. Every message you send will be processed by all member models.

Quick Deploy

The wizard's "Rapid Deployment" option auto-selects the best available model for your use case (general, coding, reasoning, or vision). One click to deploy -- the fastest way to get started.

Creating from the Sidebar

After your first bot exists, you can create additional bots at any time:

1. Click the + button in the left sidebar
2. A new profile is created with default settings
3. Configure it using the config panel on the right

The new bot starts with the Anthropic provider and a blank system prompt. Adjust the provider, model, and other settings to your needs.

Creating from the Header

The profile dropdown in the header provides quick access:

1. Click the current bot name in the header to open the profile dropdown
2. Click New Profile at the bottom of the dropdown
3. The new profile is created and becomes the active bot

Importing Profiles from JSON

You can import profiles that were exported from another device or shared as JSON files:

1. Open the Setup Wizard (click the wizard icon or go to Settings > General > Run Wizard)
2. On the path selection screen (Step 0), click Import profile from JSON
3. Select a .json file from your device
4. The import accepts:
   • A single profile object: {"name": "My Bot", "members": [{"p": "anthropic", "m": "claude-sonnet-4"}]}
   • An array of profiles: [{"name": "Bot 1", ...}, {"name": "Bot 2", ...}]
5. Imported profiles always receive new IDs to avoid collisions with existing bots

You can also import via Settings > Account > Import Data, which accepts full backup files (.json format).

note

Exported profiles come in two variants: safe export (API keys stripped) and full export (API keys included). When importing a safe export, you will need to enter API keys manually for each provider.

Bot Properties

Every bot profile has the following properties:

Property	Description	Required?
Name	Display name shown in sidebar and chat header	Yes
Provider	LLM provider (anthropic, openai, xai, gemini, openrouter, groq, ollama, etc.)	Yes
Model	Specific model ID from the provider	Yes
System Prompt	Instructions defining bot behavior (see System Prompts)	No
Temperature	Creativity/randomness (0 = deterministic, 2 = very creative, default 0.7)	No
Max Tokens	Maximum response length in tokens (default 4096)	No
Persona	Visual identity: icon, description, color (see Personas)	No
API Key	Per-bot key override (uses global key if not set)	No

For the full list of configuration fields including advanced parameters, see Bot Configuration.

Managing Bots

Switching Bots

Click any bot in the left sidebar to switch to it. The chat area loads that bot's conversation history, and the config panel updates to show its settings.

Deleting Bots

1. Hover over a bot in the sidebar to reveal the delete icon (trash can)
2. Click the trash icon
3. Confirm the deletion in the dialog

warning

Deleting a bot permanently removes it and all associated chat history from your device. This action cannot be undone. The confirmation dialog can be disabled in Settings > General > Confirm Delete, but this is not recommended.

Duplicating Bots

There is no dedicated duplicate button, but you can duplicate a bot in two ways:

• Share to yourself -- click Share, copy the URL, open it in the same browser. A new bot with the same config appears.
• Export and import -- export the profile as JSON, then import it. The imported copy receives a new ID.

Per-Bot API Keys

By default, all bots sharing the same provider use the global API key set in Settings. You can override this for individual bots:

1. Open the bot's config panel
2. Find the API Key field under the provider section
3. Enter a different key for this specific bot

Per-bot keys are useful when you have multiple API keys with different rate limits or billing accounts. They are stored in the bot configuration locally and are never included in shared URLs.