gitwtfhub

wtf is staffdeck?

openbmb/staffdeck — explained in plain English

Analysis updated 2026-05-18

841PythonAudience · pm founderComplexity · 4/5LicenseSetup · moderate

TL;DR

StaffDeck is an enterprise platform for turning an employee's work processes and decision-making into reusable, traceable digital employees that run procedures, retrieve knowledge, and act via APIs.

Mindmap

mindmap
  root((StaffDeck))
    What it does
      Builds digital employees
      State-machine procedures
      Document-aware retrieval
    Tech stack
      Python
      FastAPI
      Node.js
      MCP
    Use cases
      Automate repetitive processes
      Cite sourced answers
      Connect to business APIs
    Audience
      Enterprises and institutions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Turn a knowledge worker's repetitive process into a digital employee that can run it continuously with traceable decision records.

REASON 2

Build a document-aware retrieval system so a digital employee can locate and cite the right source before answering.

REASON 3

Connect a digital employee to real business systems through HTTP APIs, MCP, or scheduled tasks.

What's in the stack?

PythonFastAPINode.jsMCP

How it stacks up

openbmb/staffdeckpengchujin/jzsubrobbyant/lingbot-vision
Stars841841842
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity4/53/54/5
Audiencepm foundervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires Python 3.11+, Node.js 20+, and an OpenAI-compatible model endpoint and API key before first startup.

GNU AGPL-3.0: you can use and modify the platform, but if you distribute a modified version or run it as a network service, you must release your source code too.

Wtf does this do

StaffDeck is an enterprise platform for building what it calls digital employees, meaning software agents built from a person's actual work experience, business processes, and decision criteria. The idea is to turn one employee's know-how into a reusable, traceable asset that the organization keeps even if that person moves on, rather than a one-off script or a personal productivity trick. It was developed jointly by ModelBest, a data intelligence lab at Northeastern University, Tsinghua's NLP lab, OpenBMB, and AI9Stars. Each digital employee gets a position, an employee ID, a capability profile, and a work history, and can grow its capabilities over time while permissions keep it isolated from things it should not touch. Complex work is handled through state machine driven procedures generated from plain language instructions, which can switch between multiple flows, keep context, and be edited visually with version history. For finding information, StaffDeck builds a navigable index across documents at multiple levels, chapters, pages, and summaries, so a digital employee can narrow down where an answer likely lives before pulling the exact source text, and every answer can cite where it came from. Digital employees can act on real systems through HTTP APIs, MCP, and scheduled tasks, and the platform keeps long-term memory, full execution traces, a way for a human to take over, and feedback analysis to improve over time. StaffDeck ships as a desktop app for macOS, Windows, and Linux, or it can be run from source with Python 3.11 or newer and Node.js 20 or newer. Getting it running locally means cloning the repository, installing backend and frontend dependencies, configuring an OpenAI compatible model endpoint and API key in an environment file, and starting a single FastAPI process that serves the web interface, API, and documentation together. The project is licensed under the GNU AGPL-3.0 license.

Yoink these prompts

Prompt 1
Walk me through setting up StaffDeck locally with a Python virtual environment and a Node.js frontend build.
Prompt 2
Explain how StaffDeck's state-machine-driven procedures turn natural language instructions into executable workflows.
Prompt 3
How does StaffDeck's document-structure-aware retrieval decide where to look for an answer?
Prompt 4
Summarize what makes a StaffDeck digital employee different from a single AI agent script.

Frequently asked questions

wtf is staffdeck?

StaffDeck is an enterprise platform for turning an employee's work processes and decision-making into reusable, traceable digital employees that run procedures, retrieve knowledge, and act via APIs.

What language is staffdeck written in?

Mainly Python. The stack also includes Python, FastAPI, Node.js.

What license does staffdeck use?

GNU AGPL-3.0: you can use and modify the platform, but if you distribute a modified version or run it as a network service, you must release your source code too.

How hard is staffdeck to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is staffdeck for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.