Team Ai
Apppublic

graphene-lab/AgentBridge

sourceHugging Faceotherupdated 1mo agoView on Hugging Face
0likes
App README

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; closed by default (allow-list + self-enrollment through the shared access PIN, the same used for phone access).
  • —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

TechnologyWhat it means
AIOrchestrator library modelOne runtime, one agent core, one operational flow across terminal and API — no multi-server MCP overhead. Read the white paper.
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 sandboxA structural action perimeter no tool method can breach — no chroot, Docker or VMs required.
GDPR-ready anonymizationPersonal data is masked before any request reaches an external LLM provider and restored in the reply.
Kokoro neural TTSTalks the moment you run it — in the terminal, over the API and on the phone.

Demo gallery

  • —Terminal UI demo — streaming replies, / command palette, status bar
  • —Presentation generated by the agent
  • —PDF market & financial analysis report
  • —Invoice generated end-to-end · Employment contract
  • —Excel spreadsheet with chart, single A4 page
  • —Podcast sample episode (MP4, ~42 s) · MP3
  • —Telegram agent chat

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 and run agent.exe / agent.

Source & license