techtide-swarm

Python package for Swarm 357: layered orchestration of 357 Claude agent roles across six business layers, portable Memvid memory, cost controls, and a FastAPI HTTP surface.

Install

pip install techtide-swarm
swarm demo

Editable (from repo root):

pip install -e "packages/techtide-swarm[dev]"

The wheel bundles config/swarm-compact.yaml and templates/soul/ so swarm boot works after a plain pip install.

Quickstart

export ANTHROPIC_API_KEY=sk-ant-...   # or OPENROUTER_API_KEY + ANTHROPIC_BASE_URL
swarm init
swarm boot                            # loads 357-agent compact roster
swarm run "Draft a Tier-1 401 triage checklist" --budget 1.0
swarm serve --port 8000

OpenRouter (recommended for evals/cost control):

export OPENROUTER_API_KEY=...
export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export SWARM_MODEL_SONNET=anthropic/claude-sonnet-4

Public API

from techtide_swarm import (
    Agent, AgentConfig, Swarm, UltraPlan, UltraPlanConfig,
    MemoryManager, CostController, BashSecurityGate, __version__,
)
from techtide_swarm.core.types import LayerType

agent = Agent(AgentConfig(
    name="research-market-001",
    layer=LayerType.RESEARCH,
    role="market_researcher",
    soul="templates/soul/research/market-analyst.md",
    tools=["Read", "Write"],
    model="sonnet",
    budget_limit_usd=1.0,
))

Also exported: AgentResult, SwarmExecutionResult, SwarmStore, MemvidBridge, ToolRegistry, TOOLSET_MAP, registry.

CLI

HTTP API

uvicorn techtide_swarm.server:app (or swarm serve):

Environment

Docs

• Full project: TechTideOhio/swarm-357
• Evals: docs/EVALS.md
• Architecture notes: CLAUDE.md

License

Apache-2.0