openrepo-cli 0.1.0

Generate dead-simple setup guides for any GitHub repo. Even a 4-year-old could follow it.

openrepo

Generate dead-simple setup guides for any GitHub repo. Even a 4-year-old could follow it.

You give it a GitHub URL. It clones the repo, analyzes the structure, and generates a step-by-step guide with exact bash commands to get it running. No assumed knowledge.

Install

pip install openrepo

For LLM-powered guides (richer output using Claude):

pip install openrepo[llm]

Usage

Basic (no API key needed)

openrepo https://github.com/karpathy/autoresearch

This analyzes the repo locally and generates a setup guide. The guide prints to your terminal and saves to a markdown file.

With Claude (richer, more contextual guides)

export ANTHROPIC_API_KEY=your_key
openrepo https://github.com/karpathy/autoresearch --llm

Options

openrepo <github-url>           # basic local analysis
openrepo <github-url> --llm     # use Claude for richer guide
openrepo <github-url> -o FILE   # custom output path
openrepo <github-url> --keep    # keep cloned repo after analysis

What it detects

• Python projects (pip, uv, poetry, pipenv)
• Node.js projects (npm, yarn, pnpm, bun)
• Rust projects (cargo)
• Go projects (go mod)
• Docker setups
• Makefiles
• Environment variables (.env.example)
• Entry points and run commands
• Available scripts and make targets

Example output

# How to Set Up `autoresearch`

Source: https://github.com/thenamangoyal/autoresearch

## What you need first

- **Git** — https://git-scm.com
- **Python 3.10+** — https://python.org/downloads
- **uv** — `curl -LsSf https://astral.sh/uv/install.sh | sh`

## Setup (step by step)

### Step 1: Download the project

Open your terminal and run:

    git clone https://github.com/thenamangoyal/autoresearch
    cd autoresearch

### Step 2: Install Python dependencies

    uv sync

### Step 3: Run it

    uv run prepare.py
    uv run train.py

Why this exists

Open source READMEs are written by the person who built the project. They skip steps that feel obvious to them but aren't obvious to anyone else. This tool bridges that gap automatically.

License

MIT