Metadata-Version: 2.4
Name: stoa-agent
Version: 0.14.4
Summary: STOA Agent — a chamber of six sovereign LLMs + one dispatcher. Local-first, on-chain verifiable, ERC-8004 reputation. Forked from NousResearch/hermes-agent.
Author-email: STOA <hi@stoax.xyz>
License: MIT
Project-URL: Homepage, https://stoax.xyz
Project-URL: Documentation, https://stoax.xyz/docs
Project-URL: Repository, https://github.com/STOAGENT/stoa-agent
Project-URL: Issues, https://github.com/STOAGENT/stoa-agent/issues
Project-URL: Upstream, https://github.com/NousResearch/hermes-agent
Project-URL: Source, https://github.com/STOAGENT/stoa-agent
Keywords: ai,agent,llm,council,monad,erc-8004,on-chain,cli,stoa
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Security
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Shells
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai==2.24.0
Requires-Dist: python-dotenv==1.2.2
Requires-Dist: fire==0.7.1
Requires-Dist: httpx[socks]==0.28.1
Requires-Dist: rich==14.3.3
Requires-Dist: tenacity==9.1.4
Requires-Dist: pyyaml==6.0.3
Requires-Dist: ruamel.yaml==0.18.17
Requires-Dist: requests==2.33.0
Requires-Dist: jinja2==3.1.6
Requires-Dist: pydantic==2.13.4
Requires-Dist: prompt_toolkit==3.0.52
Requires-Dist: croniter==6.0.0
Requires-Dist: PyJWT[crypto]==2.12.1
Requires-Dist: tzdata==2025.3; sys_platform == "win32"
Requires-Dist: psutil==7.2.2
Requires-Dist: eth-account==0.13.7
Provides-Extra: anthropic
Requires-Dist: anthropic==0.86.0; extra == "anthropic"
Provides-Extra: exa
Requires-Dist: exa-py==2.10.2; extra == "exa"
Provides-Extra: firecrawl
Requires-Dist: firecrawl-py==4.17.0; extra == "firecrawl"
Provides-Extra: parallel-web
Requires-Dist: parallel-web==0.4.2; extra == "parallel-web"
Provides-Extra: fal
Requires-Dist: fal-client==0.13.1; extra == "fal"
Provides-Extra: edge-tts
Requires-Dist: edge-tts==7.2.7; extra == "edge-tts"
Provides-Extra: modal
Requires-Dist: modal==1.3.4; extra == "modal"
Provides-Extra: daytona
Requires-Dist: daytona==0.155.0; extra == "daytona"
Provides-Extra: vercel
Requires-Dist: vercel==0.5.7; extra == "vercel"
Provides-Extra: hindsight
Requires-Dist: hindsight-client==0.6.1; extra == "hindsight"
Provides-Extra: dev
Requires-Dist: debugpy==1.8.20; extra == "dev"
Requires-Dist: pytest==9.0.2; extra == "dev"
Requires-Dist: pytest-asyncio==1.3.0; extra == "dev"
Requires-Dist: pytest-timeout==2.4.0; extra == "dev"
Requires-Dist: mcp==1.26.0; extra == "dev"
Requires-Dist: ty==0.0.21; extra == "dev"
Requires-Dist: ruff==0.15.10; extra == "dev"
Provides-Extra: messaging
Requires-Dist: python-telegram-bot[webhooks]==22.6; extra == "messaging"
Requires-Dist: discord.py[voice]==2.7.1; extra == "messaging"
Requires-Dist: aiohttp==3.13.3; extra == "messaging"
Requires-Dist: brotlicffi==1.2.0.1; extra == "messaging"
Requires-Dist: slack-bolt==1.27.0; extra == "messaging"
Requires-Dist: slack-sdk==3.40.1; extra == "messaging"
Requires-Dist: qrcode==7.4.2; extra == "messaging"
Provides-Extra: cron
Provides-Extra: slack
Requires-Dist: slack-bolt==1.27.0; extra == "slack"
Requires-Dist: slack-sdk==3.40.1; extra == "slack"
Requires-Dist: aiohttp==3.13.3; extra == "slack"
Provides-Extra: matrix
Requires-Dist: mautrix[encryption]==0.21.0; extra == "matrix"
Requires-Dist: Markdown==3.10.2; extra == "matrix"
Requires-Dist: aiosqlite==0.22.1; extra == "matrix"
Requires-Dist: asyncpg==0.31.0; extra == "matrix"
Requires-Dist: aiohttp-socks==0.11.0; extra == "matrix"
Provides-Extra: cli
Requires-Dist: simple-term-menu==1.6.6; extra == "cli"
Provides-Extra: tts-premium
Requires-Dist: elevenlabs==1.59.0; extra == "tts-premium"
Provides-Extra: voice
Requires-Dist: faster-whisper==1.2.1; extra == "voice"
Requires-Dist: sounddevice==0.5.5; extra == "voice"
Requires-Dist: numpy==2.4.3; extra == "voice"
Provides-Extra: pty
Requires-Dist: ptyprocess==0.7.0; sys_platform != "win32" and extra == "pty"
Requires-Dist: pywinpty==2.0.15; sys_platform == "win32" and extra == "pty"
Provides-Extra: honcho
Requires-Dist: honcho-ai==2.0.1; extra == "honcho"
Provides-Extra: mcp
Requires-Dist: mcp==1.26.0; extra == "mcp"
Provides-Extra: homeassistant
Requires-Dist: aiohttp==3.13.3; extra == "homeassistant"
Provides-Extra: sms
Requires-Dist: aiohttp==3.13.3; extra == "sms"
Provides-Extra: computer-use
Requires-Dist: mcp==1.26.0; extra == "computer-use"
Provides-Extra: acp
Requires-Dist: agent-client-protocol==0.9.0; extra == "acp"
Provides-Extra: bedrock
Requires-Dist: boto3==1.42.89; extra == "bedrock"
Provides-Extra: azure-identity
Requires-Dist: azure-identity==1.25.3; extra == "azure-identity"
Provides-Extra: termux
Requires-Dist: python-telegram-bot[webhooks]==22.6; extra == "termux"
Requires-Dist: stoa-agent[cron]; extra == "termux"
Requires-Dist: stoa-agent[cli]; extra == "termux"
Requires-Dist: stoa-agent[pty]; extra == "termux"
Requires-Dist: stoa-agent[mcp]; extra == "termux"
Requires-Dist: stoa-agent[honcho]; extra == "termux"
Requires-Dist: stoa-agent[acp]; extra == "termux"
Provides-Extra: termux-all
Requires-Dist: stoa-agent[termux]; extra == "termux-all"
Requires-Dist: stoa-agent[google]; extra == "termux-all"
Requires-Dist: stoa-agent[homeassistant]; extra == "termux-all"
Requires-Dist: stoa-agent[sms]; extra == "termux-all"
Requires-Dist: stoa-agent[web]; extra == "termux-all"
Provides-Extra: dingtalk
Requires-Dist: dingtalk-stream==0.24.3; extra == "dingtalk"
Requires-Dist: alibabacloud-dingtalk==2.2.42; extra == "dingtalk"
Requires-Dist: qrcode==7.4.2; extra == "dingtalk"
Provides-Extra: feishu
Requires-Dist: lark-oapi==1.5.3; extra == "feishu"
Requires-Dist: qrcode==7.4.2; extra == "feishu"
Provides-Extra: google
Requires-Dist: google-api-python-client==2.194.0; extra == "google"
Requires-Dist: google-auth-oauthlib==1.3.1; extra == "google"
Requires-Dist: google-auth-httplib2==0.3.1; extra == "google"
Provides-Extra: youtube
Requires-Dist: youtube-transcript-api==1.2.4; extra == "youtube"
Provides-Extra: web
Requires-Dist: fastapi==0.133.1; extra == "web"
Requires-Dist: uvicorn[standard]==0.41.0; extra == "web"
Provides-Extra: all
Requires-Dist: stoa-agent[cron]; extra == "all"
Requires-Dist: stoa-agent[cli]; extra == "all"
Requires-Dist: stoa-agent[dev]; extra == "all"
Requires-Dist: stoa-agent[pty]; extra == "all"
Requires-Dist: stoa-agent[mcp]; extra == "all"
Requires-Dist: stoa-agent[homeassistant]; extra == "all"
Requires-Dist: stoa-agent[sms]; extra == "all"
Requires-Dist: stoa-agent[acp]; extra == "all"
Requires-Dist: stoa-agent[google]; extra == "all"
Requires-Dist: stoa-agent[web]; extra == "all"
Requires-Dist: stoa-agent[youtube]; extra == "all"
Dynamic: license-file

<p align="center">
  <img src="assets/banner.svg" alt="STOA Agent — six sovereign LLMs as your local agent" width="100%">
</p>

# STOA Agent ⁂

**Six sovereign LLMs as your local agent.**
Council-mode by default · On-chain verifiable · ERC-8004 reputation.

> *Hermes Agent gave you one brain on your machine. STOA gives you a chamber.*

A fork of [NousResearch / hermes-agent](https://github.com/NousResearch/hermes-agent) v0.14.0 (MIT) — see [ATTRIBUTION.md](ATTRIBUTION.md) for the full provenance.

---

## Install

**macOS · Linux · WSL2 · Termux**
```sh
curl -fsSL https://stoax.xyz/install.sh | sh
```

**Windows · PowerShell**
```powershell
iex (irm https://stoax.xyz/install.ps1)
```

**Direct from source**
```sh
git clone https://github.com/STOAGENT/stoa-agent
cd stoa-agent
uv venv && uv pip install -e .
stoa setup
```

---

## What's different from Hermes

The STOA fork preserves everything Hermes did right — the agent runtime, the 21-platform gateway, the 7-backend sandbox, the SQLite + FTS5 memory, the SKILL.md format, the uv-based one-line install — and adds the things a single-brain framework cannot:

### 1. Council mode (5-of-6 quorum)

Hermes routes a task to one LLM. STOA routes it to six (one per sovereign provider) in parallel, then a seventh dispatcher (Hermes-the-character) composes a verdict. Five of six must agree on the core position. Dissent is captured, not erased.

```sh
stoa /council "audit this contract: $(cat MyToken.sol)"
# → 6 LLMs in parallel
# → Sokrates / Mira / Veritas / Drax / Lyra / Echo each respond
# → Verdict + agreement signal + per-agent dissent + response hash
```

### 2. On-chain attestation

Every tool call optionally writes its response hash to **AuditAttestationV2** on Monad mainnet. Months later, anyone can verify a STOA agent ran exactly the action it claims it ran — without trusting the operator.

```sh
stoa --attest /council "verify this trade"
# → tx hash returned, IPFS evidence bundle pinned
```

### 3. ERC-8004 agent reputation

Each command emits a reputation event. The cross-agent reputation graph (queryable on-chain) lets other agents check a STOA agent's track record before delegating to it.

### 4. Council-audited skill publication

The hardest problem in agent skill ecosystems is supply-chain trust — OpenClaw shipped 9 CVEs in 4 days. STOA's answer: **no skill publishes without a 6-agent audit + 5-of-6 quorum + an on-chain audit hash**. Security, performance, prompt-injection, license, structure, attribution — six different lenses on every new skill.

### 5. Persona-bound provider routing

The six agents are not six instances of the same model. Each is tied to a different sovereign provider:

| Agent | Role | Marketing name |
|---|---|---|
| Sokrates | the question-maker | Claude Opus 4.7 |
| Mira | the builder | GPT-5 |
| Veritas | the auditor | Gemini 2.5 Pro |
| Drax | the red team | Grok 4 |
| Lyra | the designer | Llama 3.3 405B |
| Echo | the operator | Mistral Large 3 |
| Hermes | the dispatcher (the seventh) | — |

Set them per persona in `~/.stoa/cli-config.yaml`:

```yaml
personas:
  sokrates: { provider: anthropic, model: claude-opus-4-7,  api_mode: anthropic }
  mira:     { provider: openrouter, model: openai/gpt-5,     api_mode: chat_completions }
  veritas:  { provider: openrouter, model: google/gemini-2.5-pro }
  drax:     { provider: openrouter, model: xai/grok-4 }
  lyra:     { provider: openrouter, model: meta-llama/llama-3.3-405b }
  echo:     { provider: openrouter, model: mistralai/mistral-large-3 }
  hermes:   { provider: deepseek,  model: deepseek-chat }
```

### 6. Council mode + on-chain attestation

Solo mode, all 21 platforms, and the full skill ecosystem are free. Council mode + opt-in on-chain attestation are available to anyone in v0.x — the token gate is disabled by default (no STOA token deployed yet; the launch was cancelled).

When/if a STOA token launches, the gate activates by setting `STOA_TOKEN_CONTRACT` + `STOA_COUNCIL_MIN_HOLDING_WEI` in env. Until then, council mode is free.

```sh
# Bind your wallet (requires signing the canonical EIP-4361 bind message
# — see `stoa wallet message` for the exact string).
stoa wallet bind 0x... --signature 0x...

# Use council mode.
stoa /council "..."
```

> ⚠️ **On-chain attestation status**: the `attest_response_hash` codepath
> is a SCAFFOLD in v0.x — it computes the response hash + persists it
> locally but does not yet submit a transaction to the
> `AuditAttestationV2` contract on Monad mainnet. The M3 release wires
> the actual `eth_sendRawTransaction` transport. Until then, expect
> `attestation_enabled` to log "scaffold" + queue the request.

---

## Commands (Hermes-compatible)

| Command | What it does |
|---|---|
| `stoa` | Splash dashboard + interactive REPL (Hermes parity) |
| `stoa chat` | Direct chat mode |
| `stoa setup` | First-run wizard |
| `stoa gateway` | Run the multi-platform daemon |
| `stoa hermes migrate` | **Auto-port** your Hermes settings, skills, memories, and API keys |
| `stoa /council "<task>"` | **NEW** — six LLMs in parallel + verdict |
| `stoa /persona <name>` | **NEW** — switch single-mode agent |
| `stoa /attest` | **NEW** — stamp the last response on-chain |
| `stoa /verdict` | **NEW** — show the last council verdict |
| `stoa skill publish` | **CHANGED** — runs the 6-agent audit gate before publishing |

---

## Skills shipped under `skills/stoa/`

- `council-verdict` — orchestrate a 6-LLM call from inside a skill
- `monad-attestation` — write a hash to AuditAttestationV2
- `solidity-audit-pipeline` — Slither + Mythril + Echidna + manual review
- `erc8004-reputation` — read or write agent reputation events
- `stoa-skill-publish` — the publication audit gate itself
- `monad-mev-watchdog` — passive on-chain monitor
- `solana-anchor-audit` — Anchor-program review

---

## License

MIT for the STOA Agent codebase. See [LICENSE](LICENSE). The original
Hermes Agent license is preserved unchanged; this fork adds
[ATTRIBUTION.md](ATTRIBUTION.md).

**Bundled assets carry their own licenses:**

- `web/public/fonts-terminal/JetBrainsMono-*.woff2` — SIL Open Font
  License 1.1, see [`web/public/fonts-terminal/OFL.txt`](web/public/fonts-terminal/OFL.txt).
- `optional-skills/productivity/powerpoint/` — **Proprietary, Anthropic**.
  Opt-in only (set `STOA_ENABLE_OPTIONAL_SKILLS=1` to discover it).
  Use is governed by your separate agreement with Anthropic; the file
  `optional-skills/productivity/powerpoint/LICENSE.txt` ships the full
  terms. NOT covered by MIT.
- `optional-skills/mlops/inference/obliteratus/` — AGPL-3.0. Opt-in via
  `STOA_ENABLE_REDTEAM=1`. AGPL §13 obligations apply if you ship a
  network-accessible service that incorporates this skill.

## Links

- Docs · https://stoax.xyz/cli
- Chamber · https://stoax.xyz
- Token · [STOA on nad.fun](https://nad.fun/tokens/0xd645C10050551E93e40c4C06aF4b24F790067777)
- Source · https://github.com/STOAGENT/stoa-agent
- Upstream · https://github.com/NousResearch/hermes-agent
