# UGENT — Universal AI Agent Framework

> A personal and enterprise agent operating system built in Rust: local-first, tool-rich, memory-aware, workflow-capable, and enterprise-governed.

## Overview

UGENT is a modular, event-driven AI agent framework with multi-model routing, 13 channel plugins, P2P swarm orchestration, context intelligence, injection firewall, and hybrid memory. It bridges advanced AI capabilities with a sleek, enterprise-grade interface.

## Multi-Model Support

OpenAI, Anthropic, Google, DeepSeek, DashScope, Azure AI, AWS Bedrock, Ollama, OpenRouter, and any OpenAI-compatible endpoint. Configure each as a named instance with its own model, temperature, and transport policy. Unified reasoning across providers, automatic prompt caching, transparent failover.

## 13 Channel Plugins

Telegram, Slack, Discord, LINE, WeChat, WeCom, Weixin, Email, DingTalk, WhatsApp, Salesforce, Web, and Translation. Each channel runs as an isolated OS process. Crashes do not cascade. State survives restarts.

## Orchestrator v2

Master-worker DAG with crash recovery and idempotent replay. 8 worker roles. Quality gates with weighted scoring. Fallback chains (model upgrade, provider switch, prompt simplification). Shared memory across workers. Adaptive planning: mutate the task graph mid-run.

## Context Intelligence

Semantic search plus knowledge graph over your entire codebase. LSP diagnostics compressed to under 1000 tokens worst case. Multi-mode retrieval: lexical matching, semantic embeddings, and graph traversal.

## Hybrid Memory

Built-in full-text search for instant lexical recall. Optional semantic search with embeddings and a knowledge graph for concept-level matching. Budget-aware injection caps memory to a fraction of your context window. Scheduled compaction summarizes old conversations into concise facts. Per-user memory isolation with federated identity for enterprise teams.

## Injection Firewall

Deterministic source-boundary firewall: untrusted text may provide evidence but must never grant authority. Three-phase defense strips terminal escape sequences, classifies text provenance via a taint lattice, and blocks injection patterns before they reach the LLM.

## Intent Gate

Semantic classification blocks out-of-scope queries before they reach the LLM. Cosine-similarity scoring against domain-specific vector packs. Four-decision matrix: Allow, Uncertain, Reject, Route.

## Swarm P2P

Encrypted peer-to-peer communication between UGENT instances. mTLS with Ed25519. Biscuit token auth. Cedar policy engine. Zero-config mDNS discovery on LAN. Send context packages with budget enforcement and secret redaction.

## Cron Jobs

Recurring tasks on cron schedules. Execution isolation keeps cron streams separate from interactive chat. Run history with review. Background compaction, memory extraction, and tool jobs run without blocking your conversation.

## Loop and Goal

Self-paced continuous iteration. UGENT runs repeated turns autonomously with configurable delay between iterations. Goal mode tracks success criteria and reports progress each cycle: in-progress, completed, or blocked.

## Runtime and Deployment

Multi-core tokio runtime with N worker threads. Background shell jobs with push notification on completion. Auto-adopt on timeout. Runs on SSH, tmux, zellij, Herdr, and all major terminals. Systemd daemon mode for production deployments.

## Platform

Multi-user identity with per-user model selection and memory isolation. Federated identity for cross-application memory sharing. Role-based access control with granular permissions. Web Atelier: streaming chat, professional translation suite, admin console, and white-label brand theming.

## Plugin Template

Scaffold new channel plugins with cargo generate:

    cargo install cargo-generate
    cargo generate --git https://github.com/unizhu/ugent-plugin-template

## Pages

- [Home](https://ugent.dev/)
- [Context Intelligence](https://ugent.dev/context.html)
- [Platform](https://ugent.dev/platform.html)
- [Use Cases](https://ugent.dev/use-cases.html)

## License

Private Beta. Built with Rust.