geister 0.1.3

AI Governance Agents for Realms - CLI for managing and running citizen agents

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

Variable	Description	Default
GEISTER_API_URL	API endpoint	https://geister-api.realmsgos.dev
GEISTER_OLLAMA_URL	Ollama endpoint	https://geister-ollama.realmsgos.dev
OLLAMA_HOST	Local Ollama	http://localhost:11434
DB_PASS	Database password	-

Run geister status to see current configuration.