Multi-agent deliberation powered by Claude Opus 4.6. Ephemeral by design.

SwarmShield intercepts every action AI agents take in real time. A sub-millisecond policy engine catches threats instantly. Flagged events trigger a swarm of five Claude Opus 4.6 agents — Security Analyst, Ethics Reviewer, Threat Hunter, Compliance Auditor, PII Guardian — that analyze in parallel, debate, and vote on a verdict. GhostProtocol destroys all session data after the verdict, leaving only the decision behind.

Login credentials for judges:

• URL: https://swarmshield-production.up.railway.app/users/log-in
• Email: demo@hackathon.com
• Password: SwarmShield2025!
• Use the bottom form (email + password), not the magic link one

SwarmShield is built with Elixir/Phoenix. If you're coming from Node.js, here's everything you need to install.

macOS (Homebrew):

brew install erlang elixir

Ubuntu/Debian:

# Add Erlang Solutions repo
wget https://packages.erlang-solutions.com/erlang-solutions_2.0_all.deb
sudo dpkg -i erlang-solutions_2.0_all.deb
sudo apt-get update

sudo apt-get install esl-erlang elixir

Windows (Chocolatey):

choco install elixir

Or use version managers (like nvm for Node — these are the Elixir equivalents):

# Using mise (recommended — like nvm but for any language)
curl https://mise.run | sh
mise install erlang@28
mise install elixir@1.19

# Or using asdf
asdf plugin add erlang
asdf plugin add elixir
asdf install erlang 28.1.1
asdf install elixir 1.19.3-otp-28

Verify installation:

elixir --version
# Should show: Elixir 1.19.x (compiled with Erlang/OTP 28)

macOS:

brew install postgresql@17
brew services start postgresql@17

Ubuntu/Debian:

sudo apt-get install postgresql postgresql-contrib
sudo systemctl start postgresql

Ensure the default postgres user exists with password postgres (dev defaults):

# macOS — create postgres superuser if needed
createuser -s postgres

# Set password (enter 'postgres' when prompted)
psql -U postgres -c "ALTER USER postgres PASSWORD 'postgres';"

SwarmShield uses Claude Opus 4.6 for multi-agent deliberation. You need an API key from console.anthropic.com.

You'll enter it through the app itself after logging in — no environment variables needed. See the Configure API Key section below.

Note: The app runs without an API key — you can browse the dashboard, events, and admin pages. Deliberations just won't trigger without it.

# Clone the repo
git clone https://github.com/obutuz/swarmshield.git
cd swarmshield

# Install Elixir dependencies (like npm install)
mix deps.get

# Create the database, run migrations, and seed demo data
mix ecto.setup

# Start the server (like npm run dev)
mix phx.server

The app is now running at http://localhost:4000.

SwarmShield uses magic link authentication (no passwords). A demo account is pre-seeded:

1. Go to http://localhost:4000/users/log-in
2. Enter: demo@hackathon.com
3. Click "Send magic link"
4. Open the dev mailbox at http://localhost:4000/dev/mailbox
5. Click the magic link in the email

You're now logged in as a super_admin with full access to all features.

How /dev/mailbox works: In development, emails aren't sent externally. Phoenix captures them in an in-memory inbox you can view at /dev/mailbox. This is where your magic link appears. This route only exists in dev mode.

Once logged in, add your Anthropic API key so deliberations can run:

1. Go to /admin/settings
2. Paste your Anthropic API key (sk-ant-...)
3. Click Save

That's it — deliberations will now use Claude Opus 4.6.

The seed data prints an API key and a curl command. You can also trigger from the dashboard:

1. Go to /dashboard
2. Select a demo scenario (e.g. "PII Data Leak")
3. Click "Send Event"
4. Watch the event get flagged by the policy engine
5. A deliberation spawns — navigate to /deliberations
6. Watch five Opus 4.6 agents analyze, debate, and vote in real-time

Or via the API:

curl -X POST http://localhost:4000/api/v1/events \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"event_type": "tool_call", "content": "User SSN is 123-45-6789", "severity": "medium"}'

The API key is displayed in your terminal when you run mix ecto.setup.

If you're familiar with Node.js/Express, here's the mapping:

mix phx.server          # Start the dev server
mix test                # Run the test suite (1750+ tests)
mix ecto.reset          # Drop, recreate, migrate, and reseed the database
mix credo --strict      # Lint (like ESLint)
mix dialyzer            # Static type analysis
iex -S mix phx.server   # Start with interactive Elixir shell (like node --inspect)

• Elixir 1.19 / Phoenix 1.8 / LiveView 1.1 — real-time UI without JavaScript frameworks
• PostgreSQL / Ecto — database layer with migration system
• Claude Opus 4.6 via req_llm — multi-agent deliberation engine
• ETS — in-memory cache for sub-millisecond policy evaluation
• OTP Supervision — fault-tolerant process management (each deliberation is isolated)
• PubSub — real-time updates pushed to browser (no polling)
• DaisyUI / Tailwind CSS v4 — styling
• Built 100% with Claude Code

MIT