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.
Metadata
Release files for geister 0.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| geister-0.1.6.tar.gz | 52.1 kB | Without provenance | Details for geister-0.1.6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| geister-0.1.6-py3-none-any.whl | Python 3 | none | any | Details for geister-0.1.6-py3-none-any.whl |
Total release size: 107.3 kB
Release files / geister-0.1.6.tar.gz
| Download URL | geister-0.1.6.tar.gz |
|---|---|
| Size | 52.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e6ec151a0ff4e9ccbf492a88d8b71bc14520cf7f9cfe51fe4f44c5aa5208f37
|
|
BLAKE2b-256 checksum How to use checksums |
a09edc6dac8a6cadf3089115e62d1875b9f697a271eda59b640c2ced4eb1f08c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Release files / geister-0.1.6-py3-none-any.whl
| Download URL | geister-0.1.6-py3-none-any.whl |
|---|---|
| Size | 55.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7bc73bae8dfc6d3b91fc0d2f3bee50baeb1d254a36f43d27db327598355fc223
|
|
BLAKE2b-256 checksum How to use checksums |
a8c27f7895005ee27ff8989b05090511e4e9321a35bc99e9f35ed2b6382bb6b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Security for geister 0.1.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.