File size: 1,838 Bytes
bfc7d04
 
65888d5
bfc7d04
 
 
65888d5
 
 
 
 
 
bfc7d04
65888d5
 
 
 
 
bfc7d04
 
65888d5
bfc7d04
65888d5
bfc7d04
 
65888d5
 
 
 
 
 
bfc7d04
65888d5
 
 
bfc7d04
65888d5
bfc7d04
65888d5
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# 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