Open-Source HMAS

PRIVATE.
LOCAL.
YOURS.

Most AI agent frameworks demand cloud APIs, leak intent via clearnet searches, and lock you out while they "think." Virgo4 is engineered from the ground up for strict local-first execution, tenant isolation, and real-time collaboration.

$ git clone https://github.com/clouds-wtf/virgo4.git
$ cd virgo4

# Deploy with turnkey privacy (SearXNG via VPN)
$ docker compose --profile vpn up -d

Virgo4 orchestration initializing...
Async Python 3.12+
Core Backend
Temporal SDK
Durable Orchestration
Qdrant + TEI
Hybrid Memory Vector DB
Gluetun / Proxies
Egress Privacy Tiers

Engineering Architecture

Real-Time Interjection

Unlike traditional agents where you fire a prompt and wait, Virgo's asynchronous architecture allows for true real-time interjection. You can interrupt, steer, or correct an agent mid-thought or mid-execution natively.

[ Animated Interjection GIF Pending ]

Adaptive User Memory

Virgo doesn't just execute commands; it learns how you operate. Built-in conversational memory allows the system to continuously adapt to your infrastructure and coding style. This intelligence is strictly partitioned per account by default—your personal agent grows alongside you while remaining entirely private.

PERSONAL Tenant Isolated SHARED Team Workspace MEMORY ROUTER

Strictly Opt-In Egress

Out of the box, zero user queries hit the public internet. Web search and URL scraping tools run through prioritized failover tiers, natively supporting bundled Gluetun VPN tunnels and authenticated proxies.

AGENT DENY (Direct) PROXY GLUETUN VPN INTERNET

Durable Agent Sagas

Long-running autonomous tasks survive pod evictions and node reboots. By decoupling workflow state from the API process using Temporal, Virgo ensures execution guarantees for complex multi-agent reasoning loops.

Execution Pod Evicted TEMPORAL SDK Workflow State Preserved Sync Resume

Deep Semantic RAG

Massive documents are automatically chunked and ingested using local fastembed BM25 sparse vectors alongside Bring-Your-Own dense embeddings (routed seamlessly via Virgo's internal LiteLLM gateway). Context retrieval is merged via Reciprocal Rank Fusion (RRF) and reordered by a HuggingFace TEI cross-encoder.

Doc FASTEMBED Sparse BM25 LITELLM Dense BYOM RRF TEI Rerank

Autonomous Podcast Generation

Transform raw documents, URLs, or deep research into fully produced, multi-speaker audio podcasts. Virgo leverages local TTS models like Qwen-TTS to narrate insights organically, generating conversational audio entirely on-premise.

SCRIPT LLM Agent QWEN-TTS Local Audio