AwNode

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

Install

pip install awnode
# container image:
docker pull ghcr.io/aitherium/awnode:latest

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

Quick Start

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

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

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

# Check what's connected
awnode status

# Connect to Elysium cloud
awnode connect aither_sk_live_xxxxx

# Deploy via AitherComet
awnode 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 awnode
• Container: ghcr.io/aitherium/awnode
• Source tags: awnode-v*

---

The aw family

Standalone tools that share one idea: replace something you would otherwise have to trust with something you can check.

Each installs on its own, works offline, and needs no account.

	instead of trusting	you check
awnix	that the box is what you left it as	an immutable image you built, with atomic rollback
awnode (you are here)	a vendor’s cloud with every prompt	a local gateway routing to backends you chose
awgit	that no one else is editing this file	a lease, refused at commit time if you do not hold it
awgraph	that grep found everything	an AST + tree-sitter call graph an agent can traverse
awseal	that the artifact came from who you think	an Ed25519 seal — the key that verifies is not the key that forges
awshare	that the download is intact	content-addressed bundles, verified on fetch
awrelay	a SaaS in the middle of your agents	findings, alerts and coordination over your own transport
awm	that memory stayed in its lane	tenant:user:project scopes, so a write cannot cross a boundary
awrecover	that the restore worked	a restore that fully lands or does not land at all

awnix is the ground floor — a bootable, immutable Linux base for machines where software writes software.

Aitherium open-source ecosystem

This repo is one piece of a connected set. All public, MIT/BSL-licensed:

repo	what it is	pages
awrecover	Labelled snapshots with an all-or-nothing restore	docs
awshare	Publish an artifact and fetch it back verified	docs
awseal	Sign an artifact so a stranger can verify it	docs
awnode	Lightweight local gateway — your apps to backends you chose	docs
awnix	A bootable, immutable Linux base for agent-run machines	docs
awdk	Build AI agent fleets — 3 lines, any backend	docs
awskills	Free agent skills, scripts & automations	docs
AitherZero	PowerShell 7+ automation framework	docs
awgit	Semantic version control on top of git	docs
awgraph	Code knowledge graph for AI agents	docs
aitherkvcache	Near-optimal KV cache quantization	docs
awrelay	Agent-to-agent messaging over any chat server	docs
awm	A small world model (LeWM JEPA + MLP) to bootstrap your own	docs
AitherConnect	Browser extension: federated AI search & desktop bridge	—
homebrew-tap	brew tap aitherium/tap	—

Built by Aitherium.