Getting Started

1

Install CervellaSwarm

2 minutes

📋 Requirements

✓ macOS, Linux, or Windows (WSL)
✓ Node.js 18+ or Python 3.10+
✓ Anthropic API key (get one here)

💻 Installation

Option A: Using npm (recommended)

$ npm install -g cervellaswarm

Option B: Using pip

$ pip install cervellaswarm

Option C: From source

                    $ git clone https://github.com/cervellaswarm/cervellaswarm.git

                    $ cd cervellaswarm && ./install.sh

2

Configure Your API Key

1 minute

🔑 Set your Anthropic API key

Add to your shell profile (~/.bashrc, ~/.zshrc, etc.):

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

Or use the setup wizard:

$ cervella setup

✅ Verify installation

                    $ cervella --version

                    CervellaSwarm v1.0.0

                    16 agents ready

                    API key: configured ✓

3

Run Your First Task

2 minutes

🚀 Start a session in your project

                    $ cd your-project

                    $ cervella

The Queen will greet you and initialize SNCP memory for your project.

                    👸 CervellaSwarm initialized!

                       Project: your-project

                       SNCP: .sncp/ created

                       Agents: 16 ready

                    > What would you like to build?

💬 Ask something

Try one of these example prompts:

> "Add a dark mode toggle to the settings page"

> "Create unit tests for the user authentication module"

> "Review my API endpoints for security issues"

Watch as the Queen delegates to specialists and they work together! 🐝

4

Explore the Swarm

Ongoing

🐝 Spawn specific workers

                        $ spawn-workers --frontend

                        $ spawn-workers --backend

                        $ spawn-workers --tester

                        $ spawn-workers --list

🧠 Check SNCP memory

                        $ ls .sncp/

                        memoria/

                        idee/

                        coscienza/

📊 Open dashboard

                        $ cervella dashboard

                        Dashboard: http://localhost:5173

📚 Get help

                        $ cervella --help

                        $ cervella agents

                        $ cervella docs