EpicStaff/EpicStaff

Source-available, self-hosted platform for building AI agent flows - visual editor over a Django backend.

EpicStaff – Self‑hosted AI Agent Orchestration Platform

What it is – EpicStaff is a source‑available web application that lets teams design, run, and audit multi‑agent AI workflows. A visual, node‑based editor sits on top of a Django backend, and each node can contain custom Python code, calls to LLMs/embedders, RAG against a built‑in vector store, or integrations via the MCP protocol. Because the whole stack runs in Docker (or Podman) on your own servers, operations teams retain full ownership, security, and auditability of the flows.

Why it matters – Most current LLM agents are coded as scripts that only engineers can read or modify. EpicStaff bridges the gap between engineering (who builds integrations) and operations/auditors (who need to own, inspect, and control the processes). Every decision an agent makes is persisted in a session ledger and can be reviewed or edited through the UI without redeploying code.

Quick‑Start (3‑step summary)

Install Git and Docker (or Podman).

Clone the repo and copy the example environment file:

git clone https://github.com/EpicStaff/EpicStaff.git && cd EpicStaff/src
cp .env.example .env

Run the Docker compose stack (the script in the README also generates a secret key and creates the needed volumes/network):
```
docker compose up --build
```
Then open http://localhost in a browser to launch the visual workflow builder.

Core Technical Features (for AI engineers)

Feature	What it does
Node‑based UI	Drag‑and‑drop graph editor; each node can hold custom Python, LLM calls, or RAG logic.
LLM & embedder providers	Switch between OpenAI, Anthropic, or self‑hosted models; plug‑in any compatible inference endpoint.
Retrieval‑Augmented Generation	Upload documents, build vector indexes (Naive or GraphRAG) directly from the UI; agents can query them during a run.
Custom Python tools	Write arbitrary Python functions that become callable tools for any agent node.
Persistent agent memory	Short‑term windowed context + long‑term state stored in PostgreSQL (pgvector) and Redis, shared across sessions.
Webhooks & API triggers	Start a flow via an HTTP POST, enabling integration with CRMs, ticketing systems, etc.
Production‑ready persistence	Built‑in state management for user/organization variables; all decisions are logged in a session ledger.
Django backend	Robust, low‑latency Python server that executes the graph, enforces per‑agent permissions, and provides an audit trail.

Business‑oriented Benefits

Visual workflow builder lets non‑technical ops staff create and modify automations without touching code.
Enterprise security with role‑based access control and per‑agent permissions.
Auditability – every agent decision is stored and can be inspected or rolled back.
Multi‑agent collaboration – build “digital crews” where several agents coordinate to automate whole departments.
Extensible Python tools give unlimited integration possibilities with internal APIs.
Voice & web‑scraping capabilities enable hands‑free data collection and content generation.

Getting the Most Out of EpicStaff

Define your agents in the UI, attaching the appropriate LLM provider and any custom Python tools you need.
Create a knowledge collection (upload docs, index them) if you want RAG‑enhanced responses.
Connect to internal systems via MCP or direct Python calls; the platform will sandbox execution and enforce the permissions you set.
Deploy the Docker stack on your on‑premise servers or private cloud; use the provided cosign verification workflow to ensure the images are authentic.
Monitor & audit through the built‑in flow messages and session ledger; pause any step for manual review when required.

Community & Contribution

EpicStaff welcomes pull requests, issue reports, and new tool contributions. The project is built on the open‑source f‑flow library from the Foblex community, and the repository includes detailed contribution guidelines (CONTRIBUTING.md). Stars and forks are tracked via the usual GitHub shields.

TL;DR – EpicStaff provides a self‑hosted, Django‑backed visual platform for building, running, and auditing multi‑agent AI workflows. It combines drag‑and‑drop orchestration, persistent memory, RAG, and custom Python tooling, all under enterprise‑grade security and full auditability.