Geister

AI governance agents for Realms.

Installation

pip install -e .

Quick Start

# Check status
geister status --check

# Generate agents
geister agent generate 10

# List agents
geister agent ls

# Talk to an agent (by index or ID)
geister agent ask 1 "Please join the realm"

# Interactive session
geister agent ask 1

Modes

geister mode          # Show current mode
geister mode remote   # Use hosted API (default)
geister mode local    # Use local API

Remote Mode (default)

Connects to hosted API. No local setup required.

geister mode remote

Local Mode

Run API locally. Requires Docker.

./local.sh start    # Start PostgreSQL + API server
./local.sh stop     # Stop PostgreSQL, switch to remote
./local.sh status   # Show current status

Then in another terminal:

geister agent ask 1 "Hello"

Note: Ollama URL is configured separately via OLLAMA_HOST. You can use the remote Ollama or run locally with ollama serve.

Commands

geister
├── agent
│   ├── ls              # List agents
│   ├── generate <n>    # Create n agent identities
│   ├── ask <id> [q]    # Ask question or start chat
│   ├── inspect <id>    # Show agent data
│   └── rm <id>/--all   # Remove agent(s)
├── pod                 # RunPod management
├── server              # Local server commands
├── status              # Show configuration
├── personas            # List personas
└── version             # Show version

Environment Variables

Run geister status to see current configuration.