walidsobhie-code
reorganize: consolidate root level to 20 folders
b8e3e42
Stack 2.9 Directory Structure
Quick Overview
stack-2.9/
βββ src/ # Core source code (voice, LLM, MCP, indexing)
βββ stack/ # Components (deploy, training, eval, voice, docs)
βββ data/ # Training datasets
βββ scripts/ # Utility scripts
βββ samples/ # Examples & tests
βββ docs/ # Documentation
β
βββ README.md # Main docs
βββ LICENSE # Apache 2.0
βββ package.json # npm config
βββ pyproject.toml # Python config
βββ .env.example # Environment template
Structure Details
Root Files (User-Facing)
| File |
Purpose |
| README.md |
Main documentation |
| LICENSE |
Apache 2.0 license |
| CHANGELOG.md |
Version history |
| CONTRIBUTING.md |
Contribution guide |
| SECURITY.md |
Security policy |
| .env.example |
Environment variables |
| package.json |
npm dependencies |
| pyproject.toml |
Python project |
| requirements.txt |
Python deps |
| Dockerfile |
Container config |
| Makefile |
Build targets |
| colab_train_stack29.ipynb |
Colab training |
Core Modules (src/)
- src/voice/ - Voice integration (recording, synthesis, cloning)
- src/llm/ - Multi-provider LLM client
- src/mcp/ - Model Context Protocol client
- src/indexing/ - Code indexing (RAG)
- src/cli/ - CLI tools
- src/utils/ - Utilities
Components (stack/)
- stack/deploy/ - Docker & deployment configs
- stack/training/ - Model fine-tuning code
- stack/eval/ - Evaluation & benchmarks
- stack/voice/ - Python voice API server
- stack/docs/ - API documentation
- stack/internal/ - Internal docs (archive)
Data & Scripts
- data/ - Training datasets
- scripts/ - Build & utility scripts
- samples/ - Examples & test files