File size: 5,106 Bytes
8f16a6b | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | ---
title: AgentBridge
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: static
pinned: true
license: other
short_description: Self-hosted AI office agents — terminal chat, OpenAI-compatible API and MCP in one process
tags:
- agent
- agents
- office-automation
- rag
- self-hosted
- llm
- tts
- mcp
- telegram
- sip
---
# AgentBridge (codename "AGENT")
**Add agentic power to your work.** AgentBridge is a self-hosted server that runs AI agents with
two interfaces in a single process: a full-screen chat terminal (TUI) and a standard HTTP API
compatible with OpenAI — plus a native MCP connector. Chat in the terminal while scripts, bots and
apps use the same agents on the same port: same process, same conversations, no bridges, no
synchronization.
It encapsulates agentic functions in a well-designed **application-level sandbox** that prevents an
AI from acting outside its tools, while letting it handle real business tasks with a very high level
of privacy and confidentiality. Your documents stay on your machine: the knowledge base is a plain
folder on disk, not a cloud upload.
## What it can do
- **Documents, spreadsheets, presentations, PDF reports** generated end-to-end from a plain prompt
(Word/Excel/PowerPoint via the OfficeTool plugin family).
- **Email** — read and send mail with your account.
- **Web research** — search, sources and reports.
- **Voice** — dictate and hear the assistant speak with in-process **Kokoro neural TTS** (no setup,
voices included).
- **Phone access (SIP)** — the server becomes a phone endpoint, reachable 24/7 behind a DTMF PIN.
- **Telegram** — private-chat messaging with the agents, attachments both ways.
- **Scheduled tasks** — the agent plans work ahead and runs recurring duties on its own.
- **Podcasts** — complete podcast episodes (research → script → narration → MP3 + RSS) from one request.
- **Deterministic Memory** — a proprietary retrieval that keeps the agent grounded in everything it
has already worked on, without burning reasoning iterations on recollection.
## Key technologies
| Technology | What it means |
|---|---|
| **AIOrchestrator library model** | One runtime, one agent core, one operational flow across terminal and API — no multi-server MCP overhead. Read the [white paper](docs/AIORCHESTRATOR-WHITEPAPER.md). |
| **Universal Tool System (UTS)** | Tools are compiled .NET assemblies the agent drives natively — no Python/Node, no interpreters, in-process with zero overhead, hot-add plugins. |
| **True application-level sandbox** | A structural action perimeter no tool method can breach — no chroot, Docker or VMs required. |
| **GDPR-ready anonymization** | Personal data is masked before any request reaches an external LLM provider and restored in the reply. |
| **Kokoro neural TTS** | Talks the moment you run it — in the terminal, over the API and on the phone. |
## Demo gallery
- [Terminal UI demo](media/demo.mp4) — streaming replies, `/` command palette, status bar
- [Presentation generated by the agent](media/demo1.gif)
- [PDF market & financial analysis report](media/enanced_doc_demo.mp4)
- [Invoice generated end-to-end](media/invoice.png) · [Employment contract](media/contract.png)
- [Excel spreadsheet with chart, single A4 page](media/spreadsheet-demo.png)
- [Podcast sample episode (MP4, ~42 s)](media/podcast-example.mp4) · [MP3](media/podcast-example.mp3)
- [Telegram agent chat](media/telegram-agent.png)
## Documentation
- **[User manual](docs/MANUAL.md)** — start here: install, configure the JSON files, use the TUI, connect OpenAI/MCP clients
- **[Terminal UI reference](docs/TUI.md)** — every command, shortcut and mouse action
- **[HTTP API reference](docs/API.md)** — chat, sessions, LLM switching, TTS, voice, files, MCP connector
- **[Beginner guides](docs/INDEX.md)** — 15 short plain-language guides (getting started → podcasts)
- **[Telegram chat](docs/telegram.md)** · **[SIP telephony](docs/sip.md)** · **[Text-to-speech](docs/TTS.md)** · **[Auto-update](docs/autoupdate.md)**
- **[AIOrchestrator white paper](docs/AIORCHESTRATOR-WHITEPAPER.md)** — why the library model outperforms traditional MCP deployments
## Install
Self-contained archives (~460 MB, no .NET needed) run on Windows x64, Linux x64/ARM64 and
macOS (Intel / Apple Silicon), and work with local models (Ollama, ExLlamaV2) or cloud providers
(DeepSeek, Z.ai, Gemini, Anthropic).
```bash
# Windows (PowerShell)
irm https://graphenelab.it/AgentBridge/install.ps1 | iex
# Linux / macOS
curl -fsSL https://graphenelab.it/AgentBridge/install.sh | bash
```
Or grab the archive for your platform from the
[Releases page](https://github.com/Graphene-Lab/AgentBridge/releases/latest) and run
`agent.exe` / `agent`.
## Source & license
- **Source code:** [github.com/Graphene-Lab/AgentBridge](https://github.com/Graphene-Lab/AgentBridge)
- **License:** [Andrea Bruno License 1.4](https://github.com/Graphene-Lab/AgentBridge/blob/master/LICENSE.md)
- **Website:** [graphenelab.it/AgentBridge](https://graphenelab.it/AgentBridge/)
|