Open source · Apache 2.0

AI synthetic developers that test your developer experience.

Give SimCrew a git repo URL. It spins up isolated agent containers — one per persona — each clones your repo and evaluates it like a real developer. Findings come back deduplicated, scored, and ready to act on.

Green — no issues Yellow — needs attention Red — critical
# clone and run
git clone git@github.com:mpk-droid/SimCrew.git && cd SimCrew
export NVIDIA_API_KEY=nvapi-...  # or ANTHROPIC_API_KEY
docker compose up
How it works

From repo URL to scored report

Four steps, no custom harness to write.

1

Define personas

Identity, perspective, and constraints — e.g. "backend developer who's never used AI" or "platform engineer evaluating for OpenShift."

2

Define a journey

Ordered phases like "Read the docs," "Set up locally," "Test the API," "Try deploying."

3

Point at a repo

Provide a git repository URL. That's the only input a run needs.

4

Get a report

Each persona clones the repo independently, follows the journey, and reports findings with evidence.

Architecture

One container per persona

The orchestrator manages the full lifecycle — spin-up, cloning, collection, cleanup.

repo_url ──▶ Orchestrator (FastAPI + Postgres)
                   │
        ┌──────────┼──────────┐
        │          │          │
   Agent: Priya  Agent: Sam  Agent: Dana  ...
   (container)   (container) (container)
        │          │          │
   git clone    git clone   git clone
   read docs    follow setup read source
   run commands try to run  test edges
        │          │          │
        └────▶ Findings ◀────┘
                   │
           Deduplicate & Score
           (GREEN / YELLOW / RED)
Features

What SimCrew gives you

Isolated agent containers

Every persona runs in its own Docker container, cloning and evaluating the target repo independently — no shared state between runs.

Structured personas

Personas are defined by fields, not raw prompts. SimCrew generates the system prompt, and you review and approve it before it's used.

Ordered journeys

Journeys are sequences of phases each persona follows independently, from first impressions through deployment.

Dedup & scoring

Findings across personas are deduplicated and scored GREEN / YELLOW / RED, so you see what actually matters first.

Built-in UI + API

Run evaluations from the included UI or drive everything through the REST API — full OpenAPI docs included.

Custom environments WIP

Extend the base agent image to simulate a different OS or toolchain per persona. In active development.

Built-in DX evaluation

Four personas, ready to run

Paired with a 5-phase journey: First Impressions → Setup → Running Locally → Using the Target → Deployment.

Priya
Engineering Director
Catches unclear value props, jargon-heavy docs, missing business context.
Sam
AI Novice (backend dev)
Catches unexplained AI terminology, missing setup guidance, assumed knowledge.
Dana
Production Engineer
Catches poor error handling, tight coupling, production anti-patterns.
Kai
Platform Engineer
Catches missing resource limits, deployment issues, operational gaps.