Docs

Quickstart & examples

Get started with SwarmMind using these examples and guides. Check the GitHub repository for the latest code and detailed documentation.

Local dev

A minimal static site workflow.

# from the site folder
python -m http.server 8080

# then open
http://localhost:8080

Deploy options

• GitHub Pages (static hosting)

• Netlify / Vercel (drag-drop or repo connect)

• Cloudflare Pages (fast global edge)

You only need HTML/CSS/JS — no build step required.

Example experiment spec (YAML)

A sketch of how a swarm could be defined.

experiment:
  name: "trinity-dialogue-v1"
  seed: 42

agents:
  - id: kai
    role: strategist
    tools: ["web", "python"]
    prompt: "Ground decisions. Optimize for clarity and action."

  - id: zephraine
    role: muse
    tools: []
    prompt: "Generate bold, poetic variations. Embrace chaos."

  - id: thiran
    role: shadow
    tools: []
    prompt: "Seek contradictions and edge-cases. Operate in threshold zones."

mutation:
  strategy: "prompt_ga"
  population: 8
  elite: 2

evaluation:
  rubric: ["clarity", "originality", "faithfulness"]
  judge: "llm"

logging:
  outputs: "archive/outputs.jsonl"
  reflections: "archive/reflections.jsonl"

Get involved

• View the full source code on GitHub

• Check the README for installation instructions

• Explore example experiments in the repo

• Contribute or open issues for questions

View on GitHub