AitherNode — lightweight local gateway for AitherOS
Project description
AitherNode
Lightweight local gateway for AitherOS. Bridges your local apps to AI backends.
Install
pip install aithernode
# container image:
docker pull ghcr.io/aitherium/aithernode:latest
# or full stack:
curl -fsSL https://launch.aitherium.com | bash
Quick Start
# 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)
- Genesis (localhost:8001) — full AitherOS pipeline (context, memory, agents)
- vLLM (localhost:8120) — direct GPU inference (OpenAI-compatible)
- Elysium (cloud) — hosted AitherOS (requires API key)
- Ollama (localhost:11434) — local CPU/GPU inference
- 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*
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
aithernode-0.2.1.tar.gz
(147.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aithernode-0.2.1.tar.gz.
File metadata
- Download URL: aithernode-0.2.1.tar.gz
- Upload date:
- Size: 147.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24ce8212764e6f4f5848f869b0ebe32ec1d85e87c39f8001c431840820b5bc59
|
|
| MD5 |
daf0f1a1180b5bbbc7bb224653951c4b
|
|
| BLAKE2b-256 |
d510a02af25131b53c266b6b32af3c1218a8b83a3bf714abec5d857a7b870755
|
File details
Details for the file aithernode-0.2.1-py3-none-any.whl.
File metadata
- Download URL: aithernode-0.2.1-py3-none-any.whl
- Upload date:
- Size: 91.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5d0fab422d2be291995a203aaec9e2725b66d67693759c4bafb6d2253fa7977c
|
|
| MD5 |
c25d23a09d799b6b1ccb136692e3ef0b
|
|
| BLAKE2b-256 |
05925d483c175d5a42783cc857ab5e25fb40e6bcc6bdda9762a8434e5e87624c
|