Skip to content

Installation

Requirements

  • Python 3.11+
  • One or more LLM runtimes installed:
  • claude (Claude Code CLI)
  • gemini (Gemini CLI)
  • codex (Codex CLI)
  • aider
  • opencode
  • ollama (for local models)

Install

pip install agentspec-alpibru

Optional extras

Extra Adds When you need it
[signing] PyNaCl (Ed25519) Real cryptographic signatures for profiles
[registry] FastAPI + uvicorn Run a self-hosted registry server
[docs] MkDocs + Material theme Build documentation locally
[dev] pytest, ruff, mypy Contribute to AgentSpec 
pip install "agentspec-alpibru[signing,registry]"

Verify

agentspec --help
agentspec version

Set up at least one runtime

AgentSpec doesn't ship with LLM runtimes — it spawns whatever you have installed. Get at least one:

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_API_KEY=sk-...

npm install -g @google/gemini-cli
export GOOGLE_API_KEY=...

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3:8b

pip install aider-chat
export ANTHROPIC_API_KEY=sk-...   # or OPENAI_API_KEY

What's next