whatisgithub

What is synthtraces?

julien-c/synthtraces — explained in plain English

Analysis updated 2026-05-18

37TypeScriptAudience · researcherComplexity · 3/5LicenseSetup · moderate

In one sentence

A dataset generator that pairs two AI models in a simulated user-and-coding-agent conversation to create synthetic traces of AI coding assistant behavior on real codebases.

Mindmap

mindmap
  root((SynthTraces))
    What it does
      Simulate coding sessions
      Record traces
    Tech stack
      TypeScript
      llama.cpp
    Use cases
      Compare AI models
      Study agent behavior
    Audience
      AI researchers

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

What do people build with it?

USE CASE 1

Generate synthetic conversation traces between a simulated user and a coding agent on real codebases

USE CASE 2

Compare how different AI models like DeepSeek, OpenAI, and Qwen behave as coding agents

USE CASE 3

Study how AI agents navigate unfamiliar projects like transformers or diffusers

USE CASE 4

Download the published trace dataset from Hugging Face for offline analysis

What is it built with?

TypeScriptllama.cpp

How does it compare?

julien-c/synthtraceshotakus/opencode-visual-cacheimgoodbai/mapgogogo
Stars373737
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audienceresearcherdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Needs API access to remote agent models plus a local llama.cpp setup for the user model.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

SynthTraces is a small codebase that creates synthetic recordings of AI coding assistant conversations. The idea is to capture how an AI model behaves when a user asks it questions about a real software project, so researchers can study and compare different AI models side by side. Each session pairs two AI models together. One model acts as the user, asking questions like "How do I run this code?" or "What recent changes were made and why?" The other model acts as the coding agent, which can read files, write code, run commands, and edit files within a real project codebase. Their entire exchange is recorded as a trace. The scope of the dataset is large: 20 different agent models, 3 different user models, 20 project codebases (such as transformers and diffusers), and 20 starting questions. Multiplied together, that gives up to 24,000 unique session recordings, one for each combination. The agent models are hosted remotely and include popular open models from DeepSeek, OpenAI, and Qwen. The user models run locally using a program called llama.cpp, which lets models run on regular hardware. The project codebases are real open-source repositories, cloned locally so the coding agent can actually interact with them. This setup aims to produce realistic traces of how an AI would behave helping someone navigate an unfamiliar codebase, rather than simulated or hand-crafted examples. The trace dataset is published on Hugging Face for others to download and study. The README notes that final statistics about success rates and token counts are still to be filled in after generation is complete. The code is licensed under MIT.

Copy-paste prompts

Prompt 1
Explain how SynthTraces pairs a user model and an agent model to generate a session trace.
Prompt 2
Show me how to run the local user model with llama.cpp.
Prompt 3
How many unique session combinations does the full dataset generate?
Prompt 4
Walk me through downloading the published traces from Hugging Face.

Frequently asked questions

What is synthtraces?

A dataset generator that pairs two AI models in a simulated user-and-coding-agent conversation to create synthetic traces of AI coding assistant behavior on real codebases.

What language is synthtraces written in?

Mainly TypeScript. The stack also includes TypeScript, llama.cpp.

What license does synthtraces use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is synthtraces to set up?

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

Who is synthtraces for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.