semvec/pypi-packages huggingface dataset:
spectra-runner 1.0.3
Local test runner for Spectra DevMode - Run tests on your machine
License: MIT
Requires Python: >=3.8
Keywords: testing, docker, spectra, test-runner

# Spectra Runner

Run your tests locally with Docker! 🚀

## Installation

```bash
pip install spectra-runner
```

## Quick Start

### 1. Login (one-time)

Get your token from Spectra Dashboard → Settings → Local Runner

```bash
spectra-runner login --token YOUR_TOKEN
```

### 2. Start the runner

```bash
spectra-runner start
```

That's it! The runner will connect to Spectra and wait for test jobs.

## Commands

| Command | Description |
|---------|-------------|
| `spectra-runner login --token X` | Save your authentication token |
| `spectra-runner start` | Start the runner and wait for jobs |
| `spectra-runner logout` | Remove saved token |
| `spectra-runner status` | Check if you're logged in |

## How It Works

1. You run `spectra-runner start` in your terminal
2. When you click "Run Tests" in Spectra Dashboard, the job is sent to your runner
3. Tests run in an isolated Docker container on YOUR machine
4. Results are sent back to the Dashboard

## Security

- **Transparent**: You can see every command in your terminal
- **Isolated**: Tests run in Docker with `--network=none` (no internet access)
- **Open Source**: Audit the code yourself!
- **User Control**: You decide when to run - no background services

## Requirements

- Python 3.8+
- Docker Desktop (running)

## License

MIT
geister 0.1.6
AI Governance Agents for Realms - CLI for managing and running citizen agents
License: MIT
Requires Python: >=3.8
Keywords: ai, agents, governance, realms, llm, citizen-agents

# Geister

AI governance agents for [Realms](https://github.com/smart-social-contracts/realms).

## Installation

```bash
pip install -e .
```

## Quick Start

```bash
# 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

```bash
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.

```bash
geister mode remote
```

### Local Mode

Run API locally. Requires Docker.

```bash
./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:
```bash
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.