---
title: Early testing
description: A ten-minute, privacy-safe first-run test for Codemble.
---

Codemble needs learners who built a small Python, JavaScript, TypeScript, or
mixed project with AI and want to understand it better. Success is simple:
without maintainer help, light one system and confirm it stays lit after restart.

## Install

```bash
uvx codemble            # or: pipx install codemble && codemble
```

Codemble opens your browser to an in-app picker — pick your project folder
there, or pass one directly: `codemble ./path-to-your-project`.

An API key is optional. Do not read the rest of the docs before the first run;
the product should teach the loop itself.

## Try the loop

1. Find or choose Home.
2. In a mixed project, focus one language and return to **All**.
3. Enter a system and open one source structure.
4. Return to the system, choose **Prove understanding**, and light it.
5. Quit, run the same command, and confirm the system remains lit.

## Report the friction

Use the [early-tester issue form](https://github.com/udhawan97/Codemble/issues/new/choose).
Quote your first confusing moment verbatim. Never paste private source, project
names, credentials, or API keys. A wrong node, edge, Lens claim, line citation,
or check answer is a highest-severity correctness bug.

If you cannot light a system without help, that is valuable product evidence,
not user error.
