awnode 0.3.0__tar.gz

awnode-0.3.0/.gitignore

@@ -0,0 +1 @@
+awnode/.pybuild/

awnode-0.3.0/Dockerfile

@@ -0,0 +1,44 @@
+FROM python:3.12-slim
+
+LABEL org.opencontainers.image.title="awnode" \
+      org.opencontainers.image.description="Lightweight local gateway and MCP server for AitherOS" \
+      org.opencontainers.image.vendor="Aitherium" \
+      org.opencontainers.image.url="https://aitherium.com" \
+      org.opencontainers.image.source="https://github.com/Aitherium/aither" \
+      org.opencontainers.image.licenses="MIT"
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    AITHERNODE_PORT=8090
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    ca-certificates \
+    openssh-server \
+    && rm -rf /var/lib/apt/lists/*
+
+# Cloud-GPU providers (Vast.ai --ssh --direct, etc.) require the box to be
+# SSH-reachable once running. Root login via key only — no password auth.
+RUN sed -i \
+    -e 's/^#\?PermitRootLogin.*/PermitRootLogin yes/' \
+    -e 's/^#\?PubkeyAuthentication.*/PubkeyAuthentication yes/' \
+    -e 's/^#\?PasswordAuthentication.*/PasswordAuthentication no/' \
+    /etc/ssh/sshd_config
+
+COPY awnode/README.md awnode/pyproject.toml ./
+COPY awnode/awnode ./awnode
+COPY awnode/docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+RUN python -m pip install --upgrade pip \
+    && pip install --no-cache-dir .
+
+EXPOSE 8090 22
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
+    CMD curl -fsS http://127.0.0.1:${AITHERNODE_PORT}/health || exit 1
+
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh", "awnode"]
+CMD ["start", "--host", "0.0.0.0", "--port", "8090"]

awnode-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aitherium
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

awnode-0.3.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.5
+Name: awnode
+Version: 0.3.0
+Summary: AwNode — lightweight local gateway for AitherOS
+Project-URL: Homepage, https://aitherium.com
+Author-email: Aitherium <hello@aitherium.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,aitheros,gateway,mcp
+Requires-Python: >=3.10
+Requires-Dist: awdk>=1.3.0
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: mcp<2.0.0,>=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
+
+# AwNode
+
+Lightweight local gateway for AitherOS. Bridges your local apps to AI backends.
+
+## Install
+
+```bash
+pip install awnode
+# container image:
+docker pull ghcr.io/aitherium/awnode:latest
+
+# or full stack:
+curl -fsSL https://launch.aitherium.com | bash
+```
+
+## Quick Start
+
+```bash
+# 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*`

awnode-0.3.0/README.md

@@ -0,0 +1,73 @@
+# AwNode
+
+Lightweight local gateway for AitherOS. Bridges your local apps to AI backends.
+
+## Install
+
+```bash
+pip install awnode
+# container image:
+docker pull ghcr.io/aitherium/awnode:latest
+
+# or full stack:
+curl -fsSL https://launch.aitherium.com | bash
+```
+
+## Quick Start
+
+```bash
+# 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*`

awnode-0.3.0/_smoke_check.py

@@ -0,0 +1,12 @@
+import sys, traceback
+try:
+    import awnode
+    print("SMOKE_IMPORT: OK")
+    print("VERSION:", getattr(awnode, "__version__", "<missing>"))
+    from awnode.cli import main
+    print("CLI_MAIN_CALLABLE:", callable(main))
+except Exception as e:
+    print("SMOKE_IMPORT: FAIL")
+    print(type(e).__name__, e)
+    traceback.print_exc()
+    sys.exit(1)

awnode-0.3.0/awnode/__init__.py

@@ -0,0 +1,20 @@
+"""
+AwNode — Lightweight Local Gateway for AitherOS
+====================================================
+
+The bridge between local apps (Shell, Desktop, Connect) and AitherOS services.
+
+Modes:
+1. **Local Genesis** — proxy to localhost:8001 (full AitherOS Docker stack)
+2. **Cloud** — proxy to mcp.aitherium.com (SaaS inference + MCP tools)
+3. **Standalone** — local Ollama + basic tools (no Genesis needed)
+4. **Hybrid** — local tools + cloud LLM (best of both)
+
+Install:
+    pip install awnode
+    awnode start               # Start on port 8090
+    awnode start --cloud       # Connect to Elysium
+    awnode status              # Check what's connected
+"""
+
+__version__ = "0.3.0"

awnode-0.3.0/awnode/__main__.py

@@ -0,0 +1,6 @@
+"""Allow `python -m awnode` (used by the persistent-service installers)."""
+
+from awnode.cli import main
+
+if __name__ == "__main__":
+    main()