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.1.3.tar.gz
(124.9 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.1.3.tar.gz.
File metadata
- Download URL: aithernode-0.1.3.tar.gz
- Upload date:
- Size: 124.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b13b3c82c8580ebe395402a8d54bf89459d315c3ddbd360463025e4cd1faaf9
|
|
| MD5 |
3461cae1a05885e3d85aa70896e41f6c
|
|
| BLAKE2b-256 |
112d5b8bef0c08a2782ae2d5fdd7c12b7cb5498bd44b52b807bbab6a7691af4b
|
File details
Details for the file aithernode-0.1.3-py3-none-any.whl.
File metadata
- Download URL: aithernode-0.1.3-py3-none-any.whl
- Upload date:
- Size: 74.5 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 |
6b4623d50dcf36e7be65b020e1ab781df77fc0dfe455f9a69d4ce447267cafc5
|
|
| MD5 |
7502e0ee1966b3607048407d7be2354b
|
|
| BLAKE2b-256 |
422fd76044be959275d0c3c8f0fc632f9b8dfe5e10cddee8139c2e9710a7c1e0
|