Who Is This For?
Two minimum profiles: building this project from scratch vs installing and running it at home.
Part 1 - Why this matters
This project can be approached from two angles, but in practice a third profile shows up once you start refining the product:
- Creator profile: designs and builds the application from scratch (product + infra + local LLM stack), using an advanced LLM as an accelerator.
- Installer profile: clones the repository, follows the docs, installs dependencies, and operates the system at home.
- Maintainer/optimizer profile: polishes UX, performance, and stability after the app "works" (UI consistency, limits, security, docs, stats, and mobile fixes).
The key idea is simple: an LLM speeds up execution, but it does not replace debugging discipline, operational hygiene, or product decision-making.
Part 2 - Candidate CV (minimum viable): build from scratch
This is the minimum profile realistically able to build and evolve the app (not just run it), with an advanced LLM assisting.
- Studies (minimum): technical degree (CS/Telecom/Systems/Math/Physics) or equivalent strong self-taught background.
- Professional experience (minimum): 3-5 years of hands-on technical work (software and/or systems), ideally in environments where reliability matters.
- English: B2 minimum (C1 recommended) to navigate documentation, issues, and technical sources.
Mandatory skills (minimum level):
- HTML/CSS (responsive, tokens, dark/light): Advanced
- JavaScript (DOM, async, fetch/streams): Advanced
- Python backend (Flask or similar): Medium-Advanced
- API design (REST + streaming): Medium
- Local LLM ops (Ollama, models, allowlists): Medium
- Speech pipelines (STT/TTS modes + fallbacks): Medium
- Auth + permissions (static files, roles): Medium-Advanced
- Performance limits (caps, polling, GPU guard): Medium
- OS + shell (macOS/Linux): Advanced
- Process control (scripts, launchd): Medium
- Reverse proxy basics (Caddy/TLS): Medium
- Systematic debugging (logs + browser console): Advanced
- Product/UX decision-making: Advanced
Recommended skills (nice-to-have):
- Analytics/visualization (charts, tables, filters): Medium
- Design system thinking (pills, headers, consistency): Medium
- Security hygiene (secrets, exposure, auth): Medium
- Benchmarking and perf tests: Basic-Medium
- Release hygiene (changelogs, docs updates): Basic
Part 3 - Candidate CV (minimum viable): installer/operator
This is the minimum profile realistically able to install the repo, run the system locally, and keep it working at home using the docs and a modern LLM for assistance.
- Studies: not strictly required (technical background helps).
- Professional experience (minimum): 2-3 years of practical technical exposure (developer junior, IT technician, sysadmin junior, or power user).
- English: B1-B2 (reading errors and docs).
Mandatory skills (minimum level):
- Operating systems (macOS/Linux): Medium
- Terminal basics: Medium
- Git (clone/pull): Basic-Medium
- Dependency installation (brew/venv/pip): Medium
- Running scripts (run.sh) and reading logs: Medium
- Networking concepts (localhost, IP, ports): Basic
- Following technical documentation accurately: Advanced
- Using an LLM to debug (sharing logs, asking precise questions): Medium
Recommended skills (nice-to-have):
- Basic config editing (.chat.conf, ports): Medium
- Understanding Caddy/HTTPS at a high level: Basic
- Security hygiene (do not expose services blindly): Basic
- Understanding "services" and start/stop concepts: Basic
Part 4 - Skill level matrix (creator vs installer)
The table below summarizes the minimum skill levels required for each profile.
| Skill | Build from scratch | Install & operate |
|---|---|---|
| macOS/Linux | Advanced | Medium |
| Terminal / shell | Advanced | Medium |
| HTML/CSS (responsive) | Advanced | Basic |
| JavaScript (DOM + async) | Advanced | Basic (read-only) |
| Python backend | Medium-Advanced | Basic (read-only) |
| LLM operations (Ollama, models) | Medium | Basic |
| Speech pipeline (STT/TTS) | Medium | Basic |
| Networking (ports, LAN) | Advanced | Basic |
| Reverse proxy (Caddy) | Medium | Basic |
| Git | Medium-Advanced | Basic-Medium |
| Dependency management (venv/brew/pip) | Medium-Advanced | Medium |
| Debugging discipline | Advanced | Basic-Medium |
| Security basics | Medium | Basic |
| Docs discipline (follow steps accurately) | High | High |
This project is local-first: reliable operation depends more on system hygiene and debugging than on cloud infrastructure.
Part 5 - Quick self-check
If you are evaluating whether you can install and run this project at home, these questions are a good litmus test:
- Can you install dependencies and read terminal errors without panic?
- Do you understand what
localhostand a port are? - Can you clone a repo, run
./scripts/run.sh, and verify the app is up? - Can you pull models with Ollama and recognize a missing-model error?
- If something fails, can you capture logs and ask a modern LLM with context?
If the answers are mostly yes, the installer profile should work fine.