Metadata-Version: 2.4
Name: hermes-cld
Version: 0.1.2
Summary: The self-improving AI agent — creates skills from experience, improves them during use, and runs anywhere
Author: Nous Research, rohandalvi369
License-Expression: MIT
Requires-Python: <3.14,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai==2.24.0
Requires-Dist: certifi==2026.5.20
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: packaging==26.0
Requires-Dist: Markdown==3.10.2
Requires-Dist: PyJWT[crypto]==2.13.0
Requires-Dist: urllib3<3,>=2.7.0
Requires-Dist: cryptography==46.0.7
Requires-Dist: tzdata==2025.3; sys_platform == "win32"
Requires-Dist: psutil==7.2.2
Requires-Dist: websockets==15.0.1
Requires-Dist: pathspec==1.1.1
Requires-Dist: fastapi<1,>=0.104.0
Requires-Dist: uvicorn[standard]<1,>=0.24.0
Requires-Dist: python-multipart<1,>=0.0.9
Requires-Dist: ptyprocess<1,>=0.7.0; sys_platform != "win32"
Requires-Dist: pywinpty<3,>=2.0.0; sys_platform == "win32"
Requires-Dist: Pillow==12.2.0
Requires-Dist: concurrent-log-handler==0.9.29; sys_platform == "win32"
Provides-Extra: anthropic
Requires-Dist: anthropic==0.87.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: 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: mcp==1.26.0; extra == "dev"
Requires-Dist: starlette==1.0.1; extra == "dev"
Requires-Dist: ty==0.0.21; extra == "dev"
Requires-Dist: ruff==0.15.10; extra == "dev"
Requires-Dist: setuptools==81.0.0; 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.14.1; 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.14.1; extra == "slack"
Provides-Extra: matrix
Requires-Dist: mautrix[encryption]==0.21.0; 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"
Requires-Dist: aiohttp==3.14.1; extra == "matrix"
Provides-Extra: wecom
Requires-Dist: defusedxml==0.7.1; extra == "wecom"
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
Provides-Extra: honcho
Requires-Dist: honcho-ai==2.0.1; extra == "honcho"
Provides-Extra: supermemory
Requires-Dist: supermemory==3.50.0; extra == "supermemory"
Provides-Extra: mem0
Requires-Dist: mem0ai==2.0.10; extra == "mem0"
Provides-Extra: vision
Provides-Extra: mcp
Requires-Dist: mcp==1.26.0; extra == "mcp"
Requires-Dist: starlette==1.0.1; extra == "mcp"
Provides-Extra: nemo-relay
Requires-Dist: nemo-relay==0.3; extra == "nemo-relay"
Provides-Extra: homeassistant
Requires-Dist: aiohttp==3.14.1; extra == "homeassistant"
Provides-Extra: sms
Requires-Dist: aiohttp==3.14.1; extra == "sms"
Provides-Extra: teams
Requires-Dist: microsoft-teams-apps==2.0.13.4; extra == "teams"
Requires-Dist: aiohttp==3.14.1; extra == "teams"
Provides-Extra: computer-use
Requires-Dist: mcp==1.26.0; extra == "computer-use"
Requires-Dist: starlette==1.0.1; extra == "computer-use"
Provides-Extra: acp
Requires-Dist: agent-client-protocol==0.9.0; extra == "acp"
Provides-Extra: mistral
Requires-Dist: mistralai==2.4.8; extra == "mistral"
Provides-Extra: bedrock
Requires-Dist: boto3==1.42.89; extra == "bedrock"
Provides-Extra: vertex
Requires-Dist: google-auth==2.55.1; extra == "vertex"
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: hermes-cld[cron]; extra == "termux"
Requires-Dist: hermes-cld[cli]; extra == "termux"
Requires-Dist: hermes-cld[pty]; extra == "termux"
Requires-Dist: hermes-cld[mcp]; extra == "termux"
Requires-Dist: hermes-cld[honcho]; extra == "termux"
Requires-Dist: hermes-cld[acp]; extra == "termux"
Provides-Extra: termux-all
Requires-Dist: hermes-cld[termux]; extra == "termux-all"
Requires-Dist: hermes-cld[google]; extra == "termux-all"
Requires-Dist: hermes-cld[homeassistant]; extra == "termux-all"
Requires-Dist: hermes-cld[sms]; extra == "termux-all"
Requires-Dist: hermes-cld[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"
Requires-Dist: starlette==1.0.1; extra == "web"
Requires-Dist: python-multipart==0.0.27; extra == "web"
Provides-Extra: all
Requires-Dist: hermes-cld[cron]; extra == "all"
Requires-Dist: hermes-cld[cli]; extra == "all"
Requires-Dist: hermes-cld[pty]; extra == "all"
Requires-Dist: hermes-cld[mcp]; extra == "all"
Requires-Dist: hermes-cld[homeassistant]; extra == "all"
Requires-Dist: hermes-cld[sms]; extra == "all"
Requires-Dist: hermes-cld[acp]; extra == "all"
Requires-Dist: hermes-cld[google]; extra == "all"
Requires-Dist: hermes-cld[web]; extra == "all"
Requires-Dist: hermes-cld[youtube]; extra == "all"
Dynamic: license-file

<p align="center">
  <img src="assets/banner.png" alt="Hermes Cloud" width="100%">
</p>

# Hermes Cloud ☤

Built for projects, not just conversations. Use any model — local, Cloudflare Workers, or your own key.

No login, no account, free to start. Your chats and data stay on your machine.

---

## What makes Hermes Cloud different

**Project-first architecture** — conversations are organized around projects, not a flat chat log. Each project has its own context, tools, and scratchpad.

**Serverless reasoning on Cloudflare Workers** — run inference on Workers AI without provisioning a GPU. Bring your own Cloudflare token or use the built-in free tier.

**Privacy-first by default** — your chat history, sessions, and data stay on your machine. No accounts, no telemetry, no cloud sync. When you use a remote model (Workers AI, OpenAI, Anthropic), prompts are sent to that provider for inference — that's inherent to remote inference. Choose a local model (Ollama) to keep everything fully offline.

**Free to start, no lock-in** — bring your own API key for OpenAI, Anthropic, or any OpenAI-compatible endpoint. Or run a local model through Ollama. Switch any time with `hermes model`.

**Built on Hermes Agent** — this project is a fork of [Hermes Agent](https://github.com/NousResearch/hermes-agent) by Nous Research. It inherits the core agent loop, tool system, skills, memory, and gateway, and adds project-first organization, Workers AI integration, and a focus on local-first, no-account usage.

---

## Quick Install

### Linux, macOS, WSL2, Termux

```bash
pip install hermes-cld
hermes
```

### Windows (PowerShell)

```powershell
pip install hermes-cld
hermes
```

Requires Python 3.11–3.13. See [prerequisites](#prerequisites) below if you're on a bare system.

After installation:

```bash
hermes model      # Pick a model (local, Workers AI, or bring your own key)
hermes            # Start chatting!
```

---

## Getting Started

```bash
hermes                  # Interactive CLI — start a conversation
hermes model            # Choose provider and model
hermes project new      # Create a new project
hermes project list     # List all projects
hermes tools            # Configure which tools are enabled
hermes doctor           # Check that everything is set up correctly
```

---

## Choose Your Model

Hermes Cloud works with multiple backends — pick whichever fits your workflow:

| Backend | Setup | Cost |
|---------|-------|------|
| **Cloudflare Workers AI** | `hermes model` → select Workers AI | Free tier included; bring your own Cloudflare token for higher limits |
| **Ollama (local)** | Install Ollama, then `hermes model` → select Ollama | Free (runs on your hardware) |
| **OpenAI / compatible** | Set `OPENAI_API_KEY`, then `hermes model` → select OpenAI | Your own API key, your own billing |
| **Anthropic** | Set `ANTHROPIC_API_KEY`, then `hermes model` | Your own API key |

You're never locked in — switch with a single command.

---

## Project-First Workflow

```bash
hermes project new my-research
hermes project switch my-research
hermes project archive my-research
```

Each project has its own conversation history, tools, and working directory. Switch between them without cross-contamination.

---

## Documentation

| Topic | What's Covered |
|-------|----------------|
| [Getting Started](https://github.com/rohandalvi369/Hermes-Cloud#readme) | Install, setup, first conversation |
| [CLI Commands](https://github.com/rohandalvi369/Hermes-Cloud#getting-started) | Full command reference |
| [Providers & Models](https://github.com/rohandalvi369/Hermes-Cloud#choose-your-model) | Workers AI, Ollama, OpenAI, Anthropic |
| [Project System](https://github.com/rohandalvi369/Hermes-Cloud#project-first-workflow) | Project management |
| [Configuration](https://github.com/rohandalvi369/Hermes-Cloud) | Config file reference |

---

## Contributing

PRs and issues welcome at [github.com/rohandalvi369/Hermes-Cloud](https://github.com/rohandalvi369/Hermes-Cloud).

Development setup:

```bash
git clone https://github.com/rohandalvi369/Hermes-Cloud.git
cd Hermes-Cloud
pip install -e ".[dev]"
scripts/run_tests.sh
```

---

## License & Credits

MIT — see [LICENSE](LICENSE).

Hermes Cloud is a fork of [Hermes Agent](https://github.com/NousResearch/hermes-agent) by [Nous Research](https://nousresearch.com), used under the MIT License. See [NOTICE](NOTICE) for attribution.

The upstream Hermes Agent project is the foundation of this work — its team built the agent loop, tool system, gateway, and learning infrastructure that Hermes Cloud builds on.
