gitwtfhub

wtf is pekingman?

osama-fawad/pekingman — explained in plain English

Analysis updated 2026-05-18

817HTMLAudience · researcherComplexity · 4/5Setup · hard

TL;DR

A research project building an AI agent system that gives virtual characters like game NPCs persistent memory and consistent behavior.

Mindmap

mindmap
  root((Pekingman))
    What it does
      Perceive environment
      Remember past events
      Reason and act
    Tech stack
      Python
      Conda
      Optional GPU
    Use cases
      Build lifelike game NPCs
      Prototype digital humans
      Research agent memory systems
    Audience
      Researchers
      Game developers
      AI engineers

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

Study how a multimodal agent system combines perception, memory, reasoning, and action.

REASON 2

Prototype an NPC or digital human that remembers and reacts consistently over time.

REASON 3

Run the local demo page to see a recorded example of the agent system in action.

REASON 4

Use the project as a research artifact and cite it in academic work.

What's in the stack?

PythonCondaPyTest

How it stacks up

osama-fawad/pekingmanplannotator/effective-htmlgustavoguanabara/projeto-site
Stars817764902
LanguageHTMLHTMLHTML
Last pushed2024-07-20
MaintenanceDormant
Setup difficultyhardeasy
Complexity4/51/5
Audienceresearchervibe codervibe coder

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Advanced features need a GPU, a 3D simulation engine, and optional external services.

Wtf does this do

Pekingman is a research project that builds an agent system meant to give virtual characters, like NPCs in games or digital humans, more lifelike and consistent behavior over time. It ties together four capability areas: perception, memory, reasoning, and action, so a character can notice changes in its environment, remember past events, decide what to do based on that history and its current situation, and then act in a way that stays consistent with how it has behaved before. The project describes a persistent memory system that lets a character store, retrieve, and revisit earlier interactions, rather than resetting its understanding each time. The authors say this is meant for scenarios like virtual NPCs, digital human projects, metaverse platforms, and simulation games, particularly larger or more complex worlds where simple trigger based behavior is not enough to feel natural. According to the README's news section, the full code was released in August 2026, alongside a GitHub Pages demo page showing a project video. To run it, you need Python 3.11 and a Conda environment, set up through a provided environment file, plus optional pieces like GPU acceleration for more advanced features, a 3D simulation engine, and separate optional services for storage, model access, and speech processing that are not required just to view the documentation or demo page. There is also a static demo page you can run locally with Python's built in web server. The README notes this is an academic project associated with researchers at MIT, USC, and Université Bourgogne Europe, and includes a citation entry for anyone using it as a research artifact. It also warns that several advanced capabilities are still experimental and may not work if their optional services are not set up, and that any public release should avoid including local credentials or private data. The README does not state a software license.

Yoink these prompts

Prompt 1
Walk me through setting up the Conda environment for Pekingman and running its demo page.
Prompt 2
Explain how Pekingman's memory system is supposed to keep an NPC's behavior consistent over time.
Prompt 3
Help me understand which parts of Pekingman need a GPU versus which run on CPU only.
Prompt 4
Show me how to run Pekingman's local pytest checks and what to do if optional services are missing.

Frequently asked questions

wtf is pekingman?

A research project building an AI agent system that gives virtual characters like game NPCs persistent memory and consistent behavior.

What language is pekingman written in?

Mainly HTML. The stack also includes Python, Conda, PyTest.

How hard is pekingman to set up?

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

Who is pekingman for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

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