Metadata-Version: 2.4
Name: aithernode
Version: 0.2.1
Summary: AitherNode — lightweight local gateway for AitherOS
Author-email: Aitherium <hello@aitherium.com>
License-Expression: MIT
Keywords: agents,ai,aitheros,gateway,mcp
Requires-Python: >=3.10
Requires-Dist: aither-adk>=1.3.0
Requires-Dist: fastapi>=0.109.0
Requires-Dist: httpx>=0.26.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: uvicorn[standard]>=0.27.0
Provides-Extra: all
Requires-Dist: ollama>=0.1.0; extra == 'all'
Requires-Dist: starlette>=0.27.0; extra == 'all'
Provides-Extra: ollama
Requires-Dist: ollama>=0.1.0; extra == 'ollama'
Provides-Extra: sse
Requires-Dist: starlette>=0.27.0; extra == 'sse'
Description-Content-Type: text/markdown

# AitherNode

Lightweight local gateway for AitherOS. Bridges your local apps to AI backends.

## Install

```bash
pip install aithernode
# container image:
docker pull ghcr.io/aitherium/aithernode:latest

# or full stack:
curl -fsSL https://launch.aitherium.com | bash
```

## Quick Start

```bash
# Start with auto-detection (finds Genesis, vLLM, Ollama, or cloud)
aithernode start

# Run the published container
docker run --rm -p 8090:8090 ghcr.io/aitherium/aithernode:latest

# Force specific backend
aithernode start --vllm-url http://localhost:8120
aithernode start --cloud
aithernode start --local

# Check what's connected
aithernode status

# Connect to Elysium cloud
aithernode connect aither_sk_live_xxxxx

# Deploy via AitherComet
aithernode deploy my-service --target docker --strategy rolling
```

## Backend Priority (auto mode)

1. **Genesis** (localhost:8001) — full AitherOS pipeline (context, memory, agents)
2. **vLLM** (localhost:8120) — direct GPU inference (OpenAI-compatible)
3. **Elysium** (cloud) — hosted AitherOS (requires API key)
4. **Ollama** (localhost:11434) — local CPU/GPU inference
5. **Standalone** — no LLM, tools-only mode

## API

```
GET  /health          — Health check
GET  /status          — Backend status (what's connected)
POST /chat            — Chat (proxied to best backend)
POST /deploy          — Deploy via AitherComet
POST /connect         — Register with Elysium
```

## Environment Variables

| Variable | Default | Description |
|---|---|---|
| `AITHER_URL` | `http://localhost:8001` | Genesis URL |
| `AITHER_VLLM_URL` | `http://localhost:8120` | vLLM URL |
| `OLLAMA_HOST` | `http://localhost:11434` | Ollama URL |
| `AITHER_API_KEY` | | API key for cloud/auth |
| `AITHERNODE_MODE` | `auto` | Force mode: auto/local/cloud/standalone |
| `AITHERNODE_PORT` | `8090` | Server port |

## Release Channels

- PyPI: `pip install aithernode`
- Container: `ghcr.io/aitherium/aithernode`
- Source tags: `aithernode-v*`
