Generate an architecture diagram from a GitHub repository.
Clone it and point the app at the directory. Private repositories work exactly the same way, because nothing is uploaded to make it work.
How it works
There is no repository URL field, and that is the design rather than a missing feature. You clone, the app reads the working directory, and the analysis runs where the code already is. Anything you can clone, you can diagram, including private repositories, internal mirrors and hosts that are not GitHub, without granting an integration access to your account.
What it reads
The same survey as any codebase: manifests, README, compose and deployment files first to establish what the project is, then entry points and the import graph outward to find the boundaries. Git history is available as context when you want it, which is occasionally useful for identifying which parts of a system are actively changing and which are effectively frozen.
Why the layout can be trusted
The agent reads the files listed above and emits a semantic graph: components, the tier each belongs to, and the edges between them, with no coordinates anywhere. The ELK layout engine then computes positions and orthogonal edge routing. This is why the output cannot come back with boxes overlapping or arrows crossing through cards, which is the usual failure when a language model is asked to place things on a canvas itself.
Understanding a repository you did not write
This is the common case: an unfamiliar open source project, a service inherited from a team that has moved on, or something a coding agent generated over several sessions. A diagram is a much faster way in than a file tree, and being able to ask questions of the diagram afterwards is faster still.
Nothing is uploaded
It runs on your machine. With a local Ollama model nothing leaves the laptop at all, and with your own API key the file contents go to the provider you chose and never through us. For a source that is your actual codebase, that distinction is usually the deciding one.
Compared with hosted repo-to-diagram tools
| Lucid Train | Hosted tools | |
|---|---|---|
| Private repositories | Clone locally, no access granted | Requires OAuth access to your account |
| Where the code goes | Stays on your machine | Uploaded or read by their servers |
| Non-GitHub hosts | Anything you can clone | Usually GitHub only |
| Offline | Works with a local model | No |
| Editing the result | Edit the graph, layout re-solves | Usually regenerate and hope |
| Diagram to code | Yes, as a specification for a coding turn | No |
Clone, then diagram
Questions
Related
- Generate a Diagram from a CodebasePoint it at a repository and it surveys the code the way a new engineer would, then draws what it found.
- Generate a Diagram from TerraformTerraform already describes your infrastructure precisely. The diagram is a rendering of something you have written down, not a guess.
- Generate a Diagram from Kubernetes ManifestsKubernetes YAML contains the whole topology and presents it as several hundred lines in which none of it is visible.
- Generate a Diagram from Docker ComposeA Compose file is already a complete description of a small system. It is just written in a format that hides the shape.