- ๐ Pinned ยท 2026-07-15: StaffDeck is now open source! We welcome your feedback and support with a Star.
StaffDeck is an enterprise platform for building and managing digital employees. It helps professionals turn their work experience, business processes, and decision criteria into digital employees that can operate continuously, take over repetitive tasks, and preserve individual expertise as reusable, evolvable, and traceable organizational assets. StaffDeck is jointly developed by the ModelBest, NEU-ModelBest Data Intelligence Joint Lab, THUNLP, OpenBMB, and AI9Stars for enterprises and institutions seeking to advance AI from a personal productivity tool to an organizational capability.
- ๐งโ๐ผ Build and manage digital employees: Turn professional experience, processes, and decision criteria into digital employees with positions, employee IDs, capability profiles, and work records. Support capability growth, permission isolation, publishing, and reuse.
- ๐งฉ State-machine-driven procedural skills: Generate structured SOPs from natural language and use state machines to execute complex processes accurately. Support real-time switching across multiple flows, context preservation, visual editing, version management, and branch evolution.
- ๐ Document-structure-aware knowledge retrieval: Build navigable indexes across documents, chapters, pages, summaries, and other levels, allowing digital employees to first estimate where information may reside and then locate the original text step by step. Support knowledge buckets, targeted retrieval, source citations, and retrieval debugging.
- ๐ Autonomous execution and continuous improvement: Perform real business operations through HTTP APIs, MCP, and scheduled tasks, then close the improvement loop with long-term memory, complete traces, human takeover, user feedback, and feedback analysis.
Visit the StaffDeck official website or download the latest desktop release directly:
| Platform | Architecture | Download |
|---|---|---|
| macOS | Apple Silicon (arm64) | Download .dmg |
| Windows | x64 | Download installer .exe |
| Linux | x86_64 (Debian/Ubuntu) | Download .deb |
Paste the prompt below into Cursor, Claude Code, or Codex:
Read https://raw.githubusercontent.com/OpenBMB/StaffDeck/main/README.md.
Clone the OpenBMB/StaffDeck repository, prepare Python 3.11 and Node.js 20,
create backend/.venv, install the backend and frontend dependencies, copy
backend/.env.example to backend/.env, ask me for the OpenAI-compatible model
endpoint and API key if they are missing, run DETACH=1 scripts/dev_up.sh, and
verify /api/health plus /workspace/gallery before reporting success.
- macOS, Linux, or WSL when using the development scripts
- Python 3.11+
- Node.js 20+ and npm
- An OpenAI-compatible Chat Completions endpoint and API key
- No CUDA requirement for the application itself; hardware requirements depend on the selected model service
git clone https://github.com/OpenBMB/StaffDeck.git
cd StaffDeck
python3 -m venv backend/.venv
backend/.venv/bin/python -m pip install -e "backend[dev]"
npm --prefix frontend-enterprise ci
cp backend/.env.example backend/.envEdit backend/.env before the first startup:
APP_SECRET="replace-with-a-long-random-secret"
DEMO_MODEL_BASE_URL="https://your-openai-compatible-endpoint/v1"
DEMO_MODEL_NAME="your-model-name"
DEMO_MODEL_API_KEY="your-api-key"The API key is used to create the initial model configuration and is encrypted before being stored in the database. Do not commit backend/.env. After startup, model services can also be managed from Admin โ Model Configuration.
DETACH=1 scripts/dev_up.shThe script builds the StaffDeck frontend and serves the UI, API, and Swagger documentation from one FastAPI process on port 5173.
Initial administrator credentials: username admin, password admin. Please change the password after first login.
curl http://127.0.0.1:5173/api/healthExpected output:
{"status":"ok"}Open http://127.0.0.1:5173/workspace/gallery, select a digital employee, and send the first message. The answer and its execution record should stream into the same conversation turn.
scripts/dev_status.sh # inspect service status
scripts/dev_down.sh # stop the local service
scripts/dev_up.sh # run in the foregroundFull guide โ StaffDeck Tutorial
- Create a digital employee: Define the position, role boundaries, service style, creator, and access scope.
- Configure employee capabilities: Copy from the marketplace or create knowledge bases, general skills, SOPs, and tools without modifying marketplace originals.
- Start a session: Enter from the digital employee marketplace or employee list; the formal session is persisted after the first message is sent.
- Execute and observe: Inspect streaming intent, retrieval, skill, tool, review, and response events in the execution record.
- Intervene when necessary: Continue with queued requests, cancel a run, hand work to a person, or process pending answers.
- Operate continuously: Improve employee capabilities over time through memory, feedback, conversation logs, and scheduled tasks.
StaffDeck/
โโโ backend/ # FastAPI APIs, agent runtime, storage, and task workers
โโโ frontend-enterprise/ # React/TypeScript StaffDeck workspace
โโโ docs/ # Tutorials, APIs, schemas, and example flows
โโโ scripts/ # Single-port service lifecycle and validation scripts
โโโ packaging/ # macOS, Linux, and Windows packaging assets
โโโ README.md # English
โโโ README.zh.md # Simplified Chinese
The page opens, but the digital employee does not answer.
Check the selected model configuration, API key, model name, and model service network. Then inspect the execution record and .dev/logs/app.log to identify the exact error returned by the model service.
Can StaffDeck run without a local GPU?
Yes. The application calls an OpenAI-compatible model endpoint, so GPU requirements depend on the model service you deploy or use.
Why can regular users use marketplace resources but not edit them?
Marketplace resources are reusable templates. Regular users can copy or bind authorized resources to their own employees, while the original resources remain protected by creator and administrator permissions.
- Group chat, multi-digital-employee communication, and task division
- More enterprise connectors and reviewed marketplace resources
- Fine-grained approval policies for high-risk tool actions
Roadmap priorities are driven by real deployment needs. Please open an Issue with a reproducible scenario and expected behavior.
- For bugs and feature requests, please open a GitHub Issuesใ
- Join our community channels:
| WeChat Community | Feishu Community | Discord Community |
 |
 |
 |
Contributions from collaborators with repository access are welcome:
- Submit reproducible bugs and permission issues
- Propose digital employee, knowledge, skill, SOP, or tool workflows
- Submit focused pull requests with tests and browser validation
- Improve documentation and Chinese/English translations
Keep unrelated worktree changes intact, add tests proportional to the affected behavior, and state the routes and user roles used for UI verification in each pull request.
- Model responses can be incorrect, incomplete, or inconsistent. Execution records improve auditability but do not guarantee correctness.
- Knowledge retrieval quality depends on source-document quality, parsing, indexing, permissions, and model capabilities.
- External tools and generated runners can have real side effects. Use least-privilege credentials and configure human approval for high-risk actions.
- Scheduled tasks depend on a continuously running worker and correct user time-zone settings.
- This project is not a substitute for professional review in legal, medical, financial, security, or other regulated fields.
- Do not use this platform to process data or automate important decisions without appropriate authorization, privacy protection, and human oversight.
When using StaffDeck in internal research or authorized public materials, cite:
@software{StaffDeck2026,
title = {StaffDeck: Build, Run, and Govern Enterprise Digital Employees},
author = {OpenBMB},
year = {2026},
url = {https://github.com/OpenBMB/StaffDeck}
}This project is open source under the GNU Affero General Public License v3.0.
StaffDeck is incubated by the OpenBMB ecosystem.