bridgeagent 0.16.0__tar.gz

bridgeagent-0.16.0/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2025 Nous Research
+Copyright (c) 2026 BridgeMind (BridgeAgent fork)
+
+BridgeAgent is a fork of Nous Research's hermes-agent. The original copyright
+notice above is retained as required by the MIT License.
+
+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.

bridgeagent-0.16.0/MANIFEST.in

@@ -0,0 +1,10 @@
+graft skills
+graft optional-skills
+graft locales
+# Bundled plugin manifests (plugin.yaml / plugin.yml). Without these the
+# PluginManager scan (bridge_cli/plugins.py) finds zero plugins on installs
+# built from the sdist (e.g. Homebrew, downstream packagers). package-data
+# below covers the wheel; this covers the sdist. See #34034 / #28149.
+recursive-include plugins plugin.yaml plugin.yml
+global-exclude __pycache__
+global-exclude *.py[cod]

bridgeagent-0.16.0/PKG-INFO

@@ -0,0 +1,374 @@
+Metadata-Version: 2.4
+Name: bridgeagent
+Version: 0.16.0
+Summary: The self-improving AI agent — creates skills from experience, improves them during use, and runs anywhere
+Author: BridgeMind
+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: 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: Markdown==3.10.2
+Requires-Dist: PyJWT[crypto]==2.12.1
+Requires-Dist: tzdata==2025.3; sys_platform == "win32"
+Requires-Dist: psutil==7.2.2
+Requires-Dist: pathspec==1.1.1
+Requires-Dist: fastapi<1,>=0.104.0
+Requires-Dist: uvicorn[standard]<1,>=0.24.0
+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
+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: 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: 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==82.0.1; 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: 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: 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: 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.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"
+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: 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: bridgeagent[cron]; extra == "termux"
+Requires-Dist: bridgeagent[cli]; extra == "termux"
+Requires-Dist: bridgeagent[pty]; extra == "termux"
+Requires-Dist: bridgeagent[mcp]; extra == "termux"
+Requires-Dist: bridgeagent[honcho]; extra == "termux"
+Requires-Dist: bridgeagent[acp]; extra == "termux"
+Provides-Extra: termux-all
+Requires-Dist: bridgeagent[termux]; extra == "termux-all"
+Requires-Dist: bridgeagent[google]; extra == "termux-all"
+Requires-Dist: bridgeagent[homeassistant]; extra == "termux-all"
+Requires-Dist: bridgeagent[sms]; extra == "termux-all"
+Requires-Dist: bridgeagent[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"
+Provides-Extra: all
+Requires-Dist: bridgeagent[cron]; extra == "all"
+Requires-Dist: bridgeagent[cli]; extra == "all"
+Requires-Dist: bridgeagent[pty]; extra == "all"
+Requires-Dist: bridgeagent[mcp]; extra == "all"
+Requires-Dist: bridgeagent[homeassistant]; extra == "all"
+Requires-Dist: bridgeagent[sms]; extra == "all"
+Requires-Dist: bridgeagent[acp]; extra == "all"
+Requires-Dist: bridgeagent[google]; extra == "all"
+Requires-Dist: bridgeagent[web]; extra == "all"
+Requires-Dist: bridgeagent[youtube]; extra == "all"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/banner.png" alt="BridgeAgent" width="100%">
+</p>
+
+# BridgeAgent ☤
+
+> **BridgeAgent** is a BridgeMind fork of [Nous Research's hermes-agent](https://github.com/NousResearch/hermes-agent) (MIT). It still uses Nous Research's inference backend by default. Branding, package name, CLI commands (`bridge` / `bridgeagent` / `bridge-acp`), env vars (`BRIDGE_*`), and the config dir (`~/.bridgeagent/`) have been rebranded; model identifiers and backend endpoints are unchanged.
+
+<p align="center">
+  <a href="https://bridgeagent.ai/docs/"><img src="https://img.shields.io/badge/Docs-bridgeagent.ai-3B82F6?style=for-the-badge" alt="Documentation"></a>
+  <a href="https://bridgeagent.ai"><img src="https://img.shields.io/badge/Community-bridgeagent.ai-3B82F6?style=for-the-badge" alt="Community"></a>
+  <a href="https://github.com/BridgeMind/BridgeAgent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a>
+  <a href="https://bridgemind.dev"><img src="https://img.shields.io/badge/Built%20by-BridgeMind-blueviolet?style=for-the-badge" alt="Built by BridgeMind"></a>
+  <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-中文-red?style=for-the-badge" alt="中文"></a>
+</p>
+
+**The self-improving AI agent built by [BridgeMind](https://bridgemind.dev).** It's the only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, searches its own past conversations, and builds a deepening model of who you are across sessions. Run it on a $5 VPS, a GPU cluster, or serverless infrastructure that costs nearly nothing when idle. It's not tied to your laptop — talk to it from Telegram while it works on a cloud VM.
+
+Use any model you want — [Nous Portal](https://portal.nousresearch.com), [OpenRouter](https://openrouter.ai) (200+ models), [NovitaAI](https://novita.ai) (AI-native cloud for Model API, Agent Sandbox, and GPU Cloud), [NVIDIA NIM](https://build.nvidia.com) (Nemotron), [Xiaomi MiMo](https://platform.xiaomimimo.com), [z.ai/GLM](https://z.ai), [Kimi/Moonshot](https://platform.moonshot.ai), [MiniMax](https://www.minimax.io), [Hugging Face](https://huggingface.co), OpenAI, or your own endpoint. Switch with `bridge model` — no code changes, no lock-in.
+
+<table>
+<tr><td><b>A real terminal interface</b></td><td>Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output.</td></tr>
+<tr><td><b>Lives where you do</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity.</td></tr>
+<tr><td><b>A closed learning loop</b></td><td>Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. <a href="https://github.com/plastic-labs/honcho">Honcho</a> dialectic user modeling. Compatible with the <a href="https://agentskills.io">agentskills.io</a> open standard.</td></tr>
+<tr><td><b>Scheduled automations</b></td><td>Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended.</td></tr>
+<tr><td><b>Delegates and parallelizes</b></td><td>Spawn isolated subagents for parallel workstreams. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns.</td></tr>
+<tr><td><b>Runs anywhere, not just your laptop</b></td><td>Six terminal backends — local, Docker, SSH, Singularity, Modal, and Daytona. Daytona and Modal offer serverless persistence — your agent's environment hibernates when idle and wakes on demand, costing nearly nothing between sessions. Run it on a $5 VPS or a GPU cluster.</td></tr>
+<tr><td><b>Research-ready</b></td><td>Batch trajectory generation, trajectory compression for training the next generation of tool-calling models.</td></tr>
+</table>
+
+---
+
+## Quick Install
+
+### Linux, macOS, WSL2, Termux
+
+```bash
+curl -fsSL https://bridgeagent.ai/install.sh | bash
+```
+
+### Windows (native, PowerShell)
+
+> **Heads up:** Native Windows runs BridgeAgent without WSL — CLI, gateway, TUI, and tools all work natively. If you'd rather use WSL2, the Linux/macOS one-liner above works there too. Found a bug? Please [file issues](https://github.com/BridgeMind/BridgeAgent/issues).
+
+Run this in PowerShell:
+
+```powershell
+iex (irm https://bridgeagent.ai/install.ps1)
+```
+
+The installer handles everything: uv, Python 3.11, Node.js, ripgrep, ffmpeg, **and a portable Git Bash** (MinGit, unpacked to `%LOCALAPPDATA%\bridgeagent\git` — no admin required, completely isolated from any system Git install). BridgeAgent uses this bundled Git Bash to run shell commands.
+
+If you already have Git installed, the installer detects it and uses that instead. Otherwise a ~45MB MinGit download is all you need — it won't touch or interfere with any system Git.
+
+> **Android / Termux:** The tested manual path is documented in the [Termux guide](https://bridgeagent.ai/docs/getting-started/termux). On Termux, BridgeAgent installs a curated `.[termux]` extra because the full `.[all]` extra currently pulls Android-incompatible voice dependencies.
+>
+> **Windows:** Native Windows is fully supported — the PowerShell one-liner above installs everything. If you'd rather use WSL2, the Linux command works there too. Native Windows install lives under `%LOCALAPPDATA%\bridgeagent`; WSL2 installs under `~/.bridgeagent` as on Linux. The only BridgeAgent feature that currently needs WSL2 specifically is the browser-based dashboard chat pane (it uses a POSIX PTY — classic CLI and gateway both run natively).
+
+After installation:
+
+```bash
+source ~/.bashrc    # reload shell (or: source ~/.zshrc)
+bridge              # start chatting!
+```
+
+---
+
+## Getting Started
+
+```bash
+bridge              # Interactive CLI — start a conversation
+bridge model        # Choose your LLM provider and model
+bridge tools        # Configure which tools are enabled
+bridge config set   # Set individual config values
+bridge gateway      # Start the messaging gateway (Telegram, Discord, etc.)
+bridge setup        # Run the full setup wizard (configures everything at once)
+bridge claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
+bridge update       # Update to the latest version
+bridge doctor       # Diagnose any issues
+```
+
+📖 **[Full documentation →](https://bridgeagent.ai/docs/)**
+
+---
+
+## Skip the API-key collection — Nous Portal
+
+BridgeAgent works with whatever provider you want — that's not changing. But if you'd rather not collect five separate API keys for the model, web search, image generation, TTS, and a cloud browser, **[Nous Portal](https://portal.nousresearch.com)** covers all of them under one subscription:
+
+- **300+ models** — pick any of them with `/model <name>`
+- **Tool Gateway** — web search (Firecrawl), image generation (FAL), text-to-speech (OpenAI), cloud browser (Browser Use), all routed through your sub. No extra accounts.
+
+One command from a fresh install:
+
+```bash
+bridge setup --portal
+```
+
+That logs you in via OAuth, sets Nous as your provider, and turns on the Tool Gateway. Check what's wired up any time with `bridge portal info`. Full details on the [Tool Gateway docs page](https://bridgeagent.ai/docs/user-guide/features/tool-gateway).
+
+You can still bring your own keys per-tool whenever you want — the gateway is per-backend, not all-or-nothing.
+
+---
+
+## CLI vs Messaging Quick Reference
+
+BridgeAgent has two entry points: start the terminal UI with `bridge`, or run the gateway and talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or Email. Once you're in a conversation, many slash commands are shared across both interfaces.
+
+| Action                         | CLI                                           | Messaging platforms                                                              |
+| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
+| Start chatting                 | `bridge`                                      | Run `bridge gateway setup` + `bridge gateway start`, then send the bot a message |
+| Start fresh conversation       | `/new` or `/reset`                            | `/new` or `/reset`                                                               |
+| Change model                   | `/model [provider:model]`                     | `/model [provider:model]`                                                        |
+| Set a personality              | `/personality [name]`                         | `/personality [name]`                                                            |
+| Retry or undo the last turn    | `/retry`, `/undo`                             | `/retry`, `/undo`                                                                |
+| Compress context / check usage | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]`                                        |
+| Browse skills                  | `/skills` or `/<skill-name>`                  | `/<skill-name>`                                                                  |
+| Interrupt current work         | `Ctrl+C` or send a new message                | `/stop` or send a new message                                                    |
+| Platform-specific status       | `/platforms`                                  | `/status`, `/sethome`                                                            |
+
+For the full command lists, see the [CLI guide](https://bridgeagent.ai/docs/user-guide/cli) and the [Messaging Gateway guide](https://bridgeagent.ai/docs/user-guide/messaging).
+
+---
+
+## Documentation
+
+All documentation lives at **[bridgeagent.ai/docs](https://bridgeagent.ai/docs/)**:
+
+| Section                                                                                             | What's Covered                                             |
+| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [Quickstart](https://bridgeagent.ai/docs/getting-started/quickstart)                 | Install → setup → first conversation in 2 minutes          |
+| [CLI Usage](https://bridgeagent.ai/docs/user-guide/cli)                              | Commands, keybindings, personalities, sessions             |
+| [Configuration](https://bridgeagent.ai/docs/user-guide/configuration)                | Config file, providers, models, all options                |
+| [Messaging Gateway](https://bridgeagent.ai/docs/user-guide/messaging)                | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
+| [Security](https://bridgeagent.ai/docs/user-guide/security)                          | Command approval, DM pairing, container isolation          |
+| [Tools & Toolsets](https://bridgeagent.ai/docs/user-guide/features/tools)            | 40+ tools, toolset system, terminal backends               |
+| [Skills System](https://bridgeagent.ai/docs/user-guide/features/skills)              | Procedural memory, Skills Hub, creating skills             |
+| [Memory](https://bridgeagent.ai/docs/user-guide/features/memory)                     | Persistent memory, user profiles, best practices           |
+| [MCP Integration](https://bridgeagent.ai/docs/user-guide/features/mcp)               | Connect any MCP server for extended capabilities           |
+| [Cron Scheduling](https://bridgeagent.ai/docs/user-guide/features/cron)              | Scheduled tasks with platform delivery                     |
+| [Context Files](https://bridgeagent.ai/docs/user-guide/features/context-files)       | Project context that shapes every conversation             |
+| [Architecture](https://bridgeagent.ai/docs/developer-guide/architecture)             | Project structure, agent loop, key classes                 |
+| [Contributing](https://bridgeagent.ai/docs/developer-guide/contributing)             | Development setup, PR process, code style                  |
+| [CLI Reference](https://bridgeagent.ai/docs/reference/cli-commands)                  | All commands and flags                                     |
+| [Environment Variables](https://bridgeagent.ai/docs/reference/environment-variables) | Complete env var reference                                 |
+
+---
+
+## Migrating from OpenClaw
+
+If you're coming from OpenClaw, BridgeAgent can automatically import your settings, memories, skills, and API keys.
+
+**During first-time setup:** The setup wizard (`bridge setup`) automatically detects `~/.openclaw` and offers to migrate before configuration begins.
+
+**Anytime after install:**
+
+```bash
+bridge claw migrate              # Interactive migration (full preset)
+bridge claw migrate --dry-run    # Preview what would be migrated
+bridge claw migrate --preset user-data   # Migrate without secrets
+bridge claw migrate --overwrite  # Overwrite existing conflicts
+```
+
+What gets imported:
+
+- **SOUL.md** — persona file
+- **Memories** — MEMORY.md and USER.md entries
+- **Skills** — user-created skills → `~/.bridgeagent/skills/openclaw-imports/`
+- **Command allowlist** — approval patterns
+- **Messaging settings** — platform configs, allowed users, working directory
+- **API keys** — allowlisted secrets (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
+- **TTS assets** — workspace audio files
+- **Workspace instructions** — AGENTS.md (with `--workspace-target`)
+
+See `bridge claw migrate --help` for all options, or use the `openclaw-migration` skill for an interactive agent-guided migration with dry-run previews.
+
+---
+
+## Contributing
+
+We welcome contributions! See the [Contributing Guide](https://bridgeagent.ai/docs/developer-guide/contributing) for development setup, code style, and PR process.
+
+Quick start for contributors — clone and go with the compatibility setup helper:
+
+```bash
+git clone https://github.com/BridgeMind/BridgeAgent.git bridgeagent
+cd bridgeagent
+./setup-bridge.sh     # installs uv, creates venv, installs .[all], sets up the local CLI
+bridge                # uses the installed BridgeAgent CLI
+```
+
+Manual path (equivalent to the above):
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv venv .venv --python 3.11
+source .venv/bin/activate
+uv pip install -e ".[all,dev]"
+scripts/run_tests.sh
+```
+
+---
+
+## Community
+
+- 💬 [Community](https://bridgeagent.ai)
+- 📚 [Skills Hub](https://agentskills.io)
+- 🐛 [Issues](https://github.com/BridgeMind/BridgeAgent/issues)
+- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server for BridgeAgent and other MCP hosts, with AT-SPI accessibility trees, Wayland/X11 input, screenshots, and compositor window targeting.
+- 🔌 [BridgeClaw](https://github.com/AaronWong1999/hermesclaw) — Community WeChat bridge: Run BridgeAgent and OpenClaw on the same WeChat account.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [BridgeMind](https://bridgemind.dev).

bridgeagent-0.16.0/README.md

@@ -0,0 +1,218 @@
+<p align="center">
+  <img src="assets/banner.png" alt="BridgeAgent" width="100%">
+</p>
+
+# BridgeAgent ☤
+
+> **BridgeAgent** is a BridgeMind fork of [Nous Research's hermes-agent](https://github.com/NousResearch/hermes-agent) (MIT). It still uses Nous Research's inference backend by default. Branding, package name, CLI commands (`bridge` / `bridgeagent` / `bridge-acp`), env vars (`BRIDGE_*`), and the config dir (`~/.bridgeagent/`) have been rebranded; model identifiers and backend endpoints are unchanged.
+
+<p align="center">
+  <a href="https://bridgeagent.ai/docs/"><img src="https://img.shields.io/badge/Docs-bridgeagent.ai-3B82F6?style=for-the-badge" alt="Documentation"></a>
+  <a href="https://bridgeagent.ai"><img src="https://img.shields.io/badge/Community-bridgeagent.ai-3B82F6?style=for-the-badge" alt="Community"></a>
+  <a href="https://github.com/BridgeMind/BridgeAgent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a>
+  <a href="https://bridgemind.dev"><img src="https://img.shields.io/badge/Built%20by-BridgeMind-blueviolet?style=for-the-badge" alt="Built by BridgeMind"></a>
+  <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-中文-red?style=for-the-badge" alt="中文"></a>
+</p>
+
+**The self-improving AI agent built by [BridgeMind](https://bridgemind.dev).** It's the only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, searches its own past conversations, and builds a deepening model of who you are across sessions. Run it on a $5 VPS, a GPU cluster, or serverless infrastructure that costs nearly nothing when idle. It's not tied to your laptop — talk to it from Telegram while it works on a cloud VM.
+
+Use any model you want — [Nous Portal](https://portal.nousresearch.com), [OpenRouter](https://openrouter.ai) (200+ models), [NovitaAI](https://novita.ai) (AI-native cloud for Model API, Agent Sandbox, and GPU Cloud), [NVIDIA NIM](https://build.nvidia.com) (Nemotron), [Xiaomi MiMo](https://platform.xiaomimimo.com), [z.ai/GLM](https://z.ai), [Kimi/Moonshot](https://platform.moonshot.ai), [MiniMax](https://www.minimax.io), [Hugging Face](https://huggingface.co), OpenAI, or your own endpoint. Switch with `bridge model` — no code changes, no lock-in.
+
+<table>
+<tr><td><b>A real terminal interface</b></td><td>Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output.</td></tr>
+<tr><td><b>Lives where you do</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity.</td></tr>
+<tr><td><b>A closed learning loop</b></td><td>Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. <a href="https://github.com/plastic-labs/honcho">Honcho</a> dialectic user modeling. Compatible with the <a href="https://agentskills.io">agentskills.io</a> open standard.</td></tr>
+<tr><td><b>Scheduled automations</b></td><td>Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended.</td></tr>
+<tr><td><b>Delegates and parallelizes</b></td><td>Spawn isolated subagents for parallel workstreams. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns.</td></tr>
+<tr><td><b>Runs anywhere, not just your laptop</b></td><td>Six terminal backends — local, Docker, SSH, Singularity, Modal, and Daytona. Daytona and Modal offer serverless persistence — your agent's environment hibernates when idle and wakes on demand, costing nearly nothing between sessions. Run it on a $5 VPS or a GPU cluster.</td></tr>
+<tr><td><b>Research-ready</b></td><td>Batch trajectory generation, trajectory compression for training the next generation of tool-calling models.</td></tr>
+</table>
+
+---
+
+## Quick Install
+
+### Linux, macOS, WSL2, Termux
+
+```bash
+curl -fsSL https://bridgeagent.ai/install.sh | bash
+```
+
+### Windows (native, PowerShell)
+
+> **Heads up:** Native Windows runs BridgeAgent without WSL — CLI, gateway, TUI, and tools all work natively. If you'd rather use WSL2, the Linux/macOS one-liner above works there too. Found a bug? Please [file issues](https://github.com/BridgeMind/BridgeAgent/issues).
+
+Run this in PowerShell:
+
+```powershell
+iex (irm https://bridgeagent.ai/install.ps1)
+```
+
+The installer handles everything: uv, Python 3.11, Node.js, ripgrep, ffmpeg, **and a portable Git Bash** (MinGit, unpacked to `%LOCALAPPDATA%\bridgeagent\git` — no admin required, completely isolated from any system Git install). BridgeAgent uses this bundled Git Bash to run shell commands.
+
+If you already have Git installed, the installer detects it and uses that instead. Otherwise a ~45MB MinGit download is all you need — it won't touch or interfere with any system Git.
+
+> **Android / Termux:** The tested manual path is documented in the [Termux guide](https://bridgeagent.ai/docs/getting-started/termux). On Termux, BridgeAgent installs a curated `.[termux]` extra because the full `.[all]` extra currently pulls Android-incompatible voice dependencies.
+>
+> **Windows:** Native Windows is fully supported — the PowerShell one-liner above installs everything. If you'd rather use WSL2, the Linux command works there too. Native Windows install lives under `%LOCALAPPDATA%\bridgeagent`; WSL2 installs under `~/.bridgeagent` as on Linux. The only BridgeAgent feature that currently needs WSL2 specifically is the browser-based dashboard chat pane (it uses a POSIX PTY — classic CLI and gateway both run natively).
+
+After installation:
+
+```bash
+source ~/.bashrc    # reload shell (or: source ~/.zshrc)
+bridge              # start chatting!
+```
+
+---
+
+## Getting Started
+
+```bash
+bridge              # Interactive CLI — start a conversation
+bridge model        # Choose your LLM provider and model
+bridge tools        # Configure which tools are enabled
+bridge config set   # Set individual config values
+bridge gateway      # Start the messaging gateway (Telegram, Discord, etc.)
+bridge setup        # Run the full setup wizard (configures everything at once)
+bridge claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
+bridge update       # Update to the latest version
+bridge doctor       # Diagnose any issues
+```
+
+📖 **[Full documentation →](https://bridgeagent.ai/docs/)**
+
+---
+
+## Skip the API-key collection — Nous Portal
+
+BridgeAgent works with whatever provider you want — that's not changing. But if you'd rather not collect five separate API keys for the model, web search, image generation, TTS, and a cloud browser, **[Nous Portal](https://portal.nousresearch.com)** covers all of them under one subscription:
+
+- **300+ models** — pick any of them with `/model <name>`
+- **Tool Gateway** — web search (Firecrawl), image generation (FAL), text-to-speech (OpenAI), cloud browser (Browser Use), all routed through your sub. No extra accounts.
+
+One command from a fresh install:
+
+```bash
+bridge setup --portal
+```
+
+That logs you in via OAuth, sets Nous as your provider, and turns on the Tool Gateway. Check what's wired up any time with `bridge portal info`. Full details on the [Tool Gateway docs page](https://bridgeagent.ai/docs/user-guide/features/tool-gateway).
+
+You can still bring your own keys per-tool whenever you want — the gateway is per-backend, not all-or-nothing.
+
+---
+
+## CLI vs Messaging Quick Reference
+
+BridgeAgent has two entry points: start the terminal UI with `bridge`, or run the gateway and talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or Email. Once you're in a conversation, many slash commands are shared across both interfaces.
+
+| Action                         | CLI                                           | Messaging platforms                                                              |
+| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
+| Start chatting                 | `bridge`                                      | Run `bridge gateway setup` + `bridge gateway start`, then send the bot a message |
+| Start fresh conversation       | `/new` or `/reset`                            | `/new` or `/reset`                                                               |
+| Change model                   | `/model [provider:model]`                     | `/model [provider:model]`                                                        |
+| Set a personality              | `/personality [name]`                         | `/personality [name]`                                                            |
+| Retry or undo the last turn    | `/retry`, `/undo`                             | `/retry`, `/undo`                                                                |
+| Compress context / check usage | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]`                                        |
+| Browse skills                  | `/skills` or `/<skill-name>`                  | `/<skill-name>`                                                                  |
+| Interrupt current work         | `Ctrl+C` or send a new message                | `/stop` or send a new message                                                    |
+| Platform-specific status       | `/platforms`                                  | `/status`, `/sethome`                                                            |
+
+For the full command lists, see the [CLI guide](https://bridgeagent.ai/docs/user-guide/cli) and the [Messaging Gateway guide](https://bridgeagent.ai/docs/user-guide/messaging).
+
+---
+
+## Documentation
+
+All documentation lives at **[bridgeagent.ai/docs](https://bridgeagent.ai/docs/)**:
+
+| Section                                                                                             | What's Covered                                             |
+| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [Quickstart](https://bridgeagent.ai/docs/getting-started/quickstart)                 | Install → setup → first conversation in 2 minutes          |
+| [CLI Usage](https://bridgeagent.ai/docs/user-guide/cli)                              | Commands, keybindings, personalities, sessions             |
+| [Configuration](https://bridgeagent.ai/docs/user-guide/configuration)                | Config file, providers, models, all options                |
+| [Messaging Gateway](https://bridgeagent.ai/docs/user-guide/messaging)                | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
+| [Security](https://bridgeagent.ai/docs/user-guide/security)                          | Command approval, DM pairing, container isolation          |
+| [Tools & Toolsets](https://bridgeagent.ai/docs/user-guide/features/tools)            | 40+ tools, toolset system, terminal backends               |
+| [Skills System](https://bridgeagent.ai/docs/user-guide/features/skills)              | Procedural memory, Skills Hub, creating skills             |
+| [Memory](https://bridgeagent.ai/docs/user-guide/features/memory)                     | Persistent memory, user profiles, best practices           |
+| [MCP Integration](https://bridgeagent.ai/docs/user-guide/features/mcp)               | Connect any MCP server for extended capabilities           |
+| [Cron Scheduling](https://bridgeagent.ai/docs/user-guide/features/cron)              | Scheduled tasks with platform delivery                     |
+| [Context Files](https://bridgeagent.ai/docs/user-guide/features/context-files)       | Project context that shapes every conversation             |
+| [Architecture](https://bridgeagent.ai/docs/developer-guide/architecture)             | Project structure, agent loop, key classes                 |
+| [Contributing](https://bridgeagent.ai/docs/developer-guide/contributing)             | Development setup, PR process, code style                  |
+| [CLI Reference](https://bridgeagent.ai/docs/reference/cli-commands)                  | All commands and flags                                     |
+| [Environment Variables](https://bridgeagent.ai/docs/reference/environment-variables) | Complete env var reference                                 |
+
+---
+
+## Migrating from OpenClaw
+
+If you're coming from OpenClaw, BridgeAgent can automatically import your settings, memories, skills, and API keys.
+
+**During first-time setup:** The setup wizard (`bridge setup`) automatically detects `~/.openclaw` and offers to migrate before configuration begins.
+
+**Anytime after install:**
+
+```bash
+bridge claw migrate              # Interactive migration (full preset)
+bridge claw migrate --dry-run    # Preview what would be migrated
+bridge claw migrate --preset user-data   # Migrate without secrets
+bridge claw migrate --overwrite  # Overwrite existing conflicts
+```
+
+What gets imported:
+
+- **SOUL.md** — persona file
+- **Memories** — MEMORY.md and USER.md entries
+- **Skills** — user-created skills → `~/.bridgeagent/skills/openclaw-imports/`
+- **Command allowlist** — approval patterns
+- **Messaging settings** — platform configs, allowed users, working directory
+- **API keys** — allowlisted secrets (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
+- **TTS assets** — workspace audio files
+- **Workspace instructions** — AGENTS.md (with `--workspace-target`)
+
+See `bridge claw migrate --help` for all options, or use the `openclaw-migration` skill for an interactive agent-guided migration with dry-run previews.
+
+---
+
+## Contributing
+
+We welcome contributions! See the [Contributing Guide](https://bridgeagent.ai/docs/developer-guide/contributing) for development setup, code style, and PR process.
+
+Quick start for contributors — clone and go with the compatibility setup helper:
+
+```bash
+git clone https://github.com/BridgeMind/BridgeAgent.git bridgeagent
+cd bridgeagent
+./setup-bridge.sh     # installs uv, creates venv, installs .[all], sets up the local CLI
+bridge                # uses the installed BridgeAgent CLI
+```
+
+Manual path (equivalent to the above):
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv venv .venv --python 3.11
+source .venv/bin/activate
+uv pip install -e ".[all,dev]"
+scripts/run_tests.sh
+```
+
+---
+
+## Community
+
+- 💬 [Community](https://bridgeagent.ai)
+- 📚 [Skills Hub](https://agentskills.io)
+- 🐛 [Issues](https://github.com/BridgeMind/BridgeAgent/issues)
+- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server for BridgeAgent and other MCP hosts, with AT-SPI accessibility trees, Wayland/X11 input, screenshots, and compositor window targeting.
+- 🔌 [BridgeClaw](https://github.com/AaronWong1999/hermesclaw) — Community WeChat bridge: Run BridgeAgent and OpenClaw on the same WeChat account.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [BridgeMind](https://bridgemind.dev).

bridgeagent-0.16.0/acp_adapter/__init__.py

@@ -0,0 +1 @@
+"""ACP (Agent Communication Protocol) adapter for BridgeAgent."""

bridgeagent-0.16.0/acp_adapter/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running the ACP adapter as ``python -m acp_adapter``."""
+
+from .entry import main
+
+main()