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.0.tar.gz
(146.2 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.0.tar.gz.
File metadata
- Download URL: aithernode-0.2.0.tar.gz
- Upload date:
- Size: 146.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ec5a774cdc2ff6af8495e01b12d283a23cf1e707bdc67836ad1a38f98bba198e
|
|
| MD5 |
03cf6e3de318ec19a208295125b07de8
|
|
| BLAKE2b-256 |
33c2f8ee03fcaf70134e6c469d97fa50cf2005032a2b29f05553bd2bf820d648
|
File details
Details for the file aithernode-0.2.0-py3-none-any.whl.
File metadata
- Download URL: aithernode-0.2.0-py3-none-any.whl
- Upload date:
- Size: 90.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 |
81915deb0806264d2a4a29b4cc646aa067993888ba152a30902c57bc40178a18
|
|
| MD5 |
69a88475397fbff8f419c6f991bf66d7
|
|
| BLAKE2b-256 |
dc22b3304dcfb3ac72997b621a0dc00b83d9da7ed69529111df9ae9e4e12a7d0
|