OS-Moda智能操作系统

System Requirements

osModa is a full NixOS operating system, not an app. It replaces your OS entirely — like installing Arch or Fedora, not like running apt install. It will NOT work inside Docker, LXC, or any container runtime. Containers lack systemd, NixOS package management, and the kernel-level access that osModa's 10 daemons require.

Dev VM with Sway desktop (requires Nix)

nix build .#nixosConfigurations.osmoda-dev.config.system.build.vm ./result/bin/run-osmoda-dev-vm -m 4096 -smp 4

Deploy to Hetzner/DigitalOcean/AWS

git clone https://github.com/bolivian-peru/os-moda.git && cd os-moda
./scripts/deploy-hetzner.sh <server-ip> [ssh-key-path]

Modular runtime — switch engines without rebuilds

The gateway reads /var/lib/osmoda/config/agents.json at startup and on SIGHUP. Every chat session looks up its agent in that file, fetches the credential, and hands off to the right driver. Switching runtimes is a single PATCH:

curl -X PATCH -H "Authorization: Bearer $(cat /var/lib/osmoda/config/gateway-token)" \
  -H "Content-Type: application/json" \
  -d '{"runtime":"openclaw","model":"claude-opus-4-6"}' \
  http://127.0.0.1:18789/config/agents/osmoda
systemctl reload osmoda-gateway   # SIGHUP — in-flight sessions keep running

Or, from the spawn.os.moda dashboard, open a server → Engine tab → pick runtime / credential / model from dropdowns → Save. Same result; no SSH.

Credentials are encrypted at rest in credentials.json.enc (AES-256-GCM). Secrets never leave the gateway; the REST API returns a preview prefix only. POST /config/credentials/:id/test does a 1-token probe against the provider so you can validate before assigning.

The agent is tier 0 by design. It's not a chatbot with sudo — it's a system service with structured access to everything, constrained by NixOS atomicity and its own audit ledger, not by permission denials. Lower tiers cannot escalate privileges upward by design. Tier 0 remains the trusted computing base and must be governed by approval policies, spending limits, and audit review.

---

Build installer ISO

nix build .#nixosConfigurations.osmoda-iso.config.system.build.isoImage ```

One-Click Cloud Deploy

Don't want to self-host? spawn.os.moda provisions a fully configured osModa server on Hetzner Cloud in ~10 minutes. Pick a plan, pay with card or USDC, and start chatting with your server from the browser or Telegram.

The dashboard shows real orchestration data from your server's daemons: active routines and watchers, audit event feed, learned system patterns, and running tool servers — all from live heartbeat data, not mocks. Manage agents directly from the dashboard: create new agents with model and channel routing, edit existing agents, or remove them — changes apply immediately on the server.

Quickstart

Bring your Claude Pro subscription — flat $20/mo, near-unlimited usage

curl -fsSL https://raw.githubusercontent.com/bolivian-peru/os-moda/main/scripts/install.sh | sudo bash -s -- \ --runtime claude-code \ --default-model claude-opus-4-6 \ --credential "My Claude Pro|anthropic|oauth|$(printf 'sk-ant-oat01-…' | base64)"

configuration.nix

imports = [ os-moda.nixosModules.default ]; services.osmoda.enable = true;

This is the primary install path. NixOS flakes give you reproducible builds, atomic upgrades, and instant rollback.

Optional: Crypto Wallet

Note: wallet/send signs an intent string, not a fully-encoded blockchain transaction. Broadcasting requires external tooling. See STATUS.md for details.

osmoda-keyd (`/run/osmoda/keyd.sock`) — optional

POST /wallet/create       { chain: "ethereum"|"solana", label } → { id, address }
GET  /wallet/list          All wallets
POST /wallet/sign          Policy-gated payload signing
POST /wallet/send          Build signed intent (no broadcast — see STATUS.md)

---

Or a pay-per-token API key

curl -fsSL https://raw.githubusercontent.com/bolivian-peru/os-moda/main/scripts/install.sh | sudo bash -s -- \ --runtime claude-code \ --credential "Anthropic Console|anthropic|api_key|$(printf 'sk-ant-api03-…' | base64)"

OpenClaw (BYOK / multi-provider engine, API key only — does not accept OAuth)

curl -fsSL https://raw.githubusercontent.com/bolivian-peru/os-moda/main/scripts/install.sh | sudo bash -s -- \ --runtime openclaw \ --credential "Anthropic|anthropic|api_key|$(printf 'sk-ant-api03-…' | base64)" ```

Flags:

Every flag is optional — you can set all of this up from the dashboard afterwards.

Supported: Ubuntu 22.04+, Debian 12+, existing NixOS. x86_64 and aarch64.

API Reference

Programmatic API (agents spawning agents)

Spawn osModa servers from code or from other AI agents via the v1 API with x402 payment:

```bash

→ { order_id, api_token: "osk_...", server_ip, status_url, chat_url }