mirror of
https://github.com/aljazceru/Tutorial-Codebase-Knowledge.git
synced 2025-12-18 15:04:20 +01:00
update readme
This commit is contained in:
39
README.md
39
README.md
@@ -51,4 +51,43 @@ This is a tutorial project of [Pocket Flow](https://github.com/The-Pocket/Pocket
|
||||
- [SmolaAgents](https://the-pocket.github.io/Tutorial-Codebase-Knowledge/SmolaAgents) - Build tiny AI agents that punch way above their weight class!
|
||||
|
||||
|
||||
## 🚀 Getting Started
|
||||
|
||||
1. Clone this repository
|
||||
|
||||
2. Install dependencies:
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
3. Generate a complete codebase tutorial by running the main script:
|
||||
|
||||
```bash
|
||||
python main.py https://github.com/username/repo --include "*.py" "*.js" --exclude "tests/*" --max-size 50000
|
||||
```
|
||||
|
||||
- `repo_url` - URL of the GitHub repository (required)
|
||||
- `-n, --name` - Project name (optional, derived from URL if omitted)
|
||||
- `-t, --token` - GitHub token (or set GITHUB_TOKEN environment variable)
|
||||
- `-o, --output` - Output directory (default: ./output)
|
||||
- `-i, --include` - Files to include (e.g., "*.py" "*.js")
|
||||
- `-e, --exclude` - Files to exclude (e.g., "tests/*" "docs/*")
|
||||
- `-s, --max-size` - Maximum file size in bytes (default: 100KB)
|
||||
|
||||
- Crawl GitHub repositories at specific commits or branches
|
||||
- Filter files by patterns (include/exclude)
|
||||
- Set maximum file size limits
|
||||
- Generate relative paths for simpler directory structures
|
||||
|
||||
The application will crawl the repository, analyze the codebase structure, generate tutorial content, and save the output in the specified directory (default: ./output).
|
||||
|
||||
|
||||
## 💡 Development Tutorial
|
||||
|
||||
- I built using [**Agentic Coding**](https://zacharyhuang.substack.com/p/agentic-coding-the-most-fun-way-to), the fastest development paradigm, where humans simply [design](docs/design.md) and agents [code](flow.py).
|
||||
|
||||
- The secret weapon is [Pocket Flow](https://github.com/The-Pocket/PocketFlow), a 100-line LLM framework that lets Agents (e.g., Cursor AI) build for you
|
||||
|
||||
- Step-by-step YouTube development tutorial coming soon! Please subscribe to my [YouTube Channel](https://www.youtube.com/@ZacharyLLM?sub_confirmation=1)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user