Get started
Install louped, make a project and run the example.
You need Python 3.12 or newer.
pip install 'louped[server,tracking,interp,agent]'
louped init my-research
cd my-research
louped serveOpen http://127.0.0.1:8000. Go to Launch, pick does-pushback-flip-answers and press
Launch. Tick tiny to try it offline without downloading a model. When the run finishes, open
it and read the Items tab.
What louped init makes
| Path | What it is |
|---|---|
louped.toml | Marks the project's root. Commands work from any subfolder. |
experiments/ | One folder per question. The example is here. |
AGENTS.md | Instructions for your coding agent. |
.mcp.json | Connects your agent to the app. |
.louped/ | Runs, logs and jobs. Not committed to git. |
Extras
Install only what you use.
| Extra | Adds |
|---|---|
server | The app (louped serve) |
tracking | Run records, and GPU, CPU and memory use during each run |
interp | Loading models, interventions and analyses (torch, nnsight) |
agent | The MCP server your coding agent uses (louped mcp) |
evals | Inspect evals |
train | Fine-tuning (TRL, PEFT) |
rl | Tasks with checkable answers, for GRPO |
rag | Retrieval (bm25s, sentence-transformers) |
sae | Sparse autoencoders (SAELens) |
data | Building training sets from logged model calls |
Results you already have
louped view path/to/resultsThis opens Inspect logs, an MLflow store, or any folder of JSONL, JSON, CSV or Markdown files in the app, read-only. No project is needed.
From source
You need just, uv and Node 22 with pnpm.
git clone https://github.com/ashworks1706/louped && cd louped
just bootstrap
just serve