Awesome AI Handbook
A practical guide to AI: from running your first local model to building your own agents.
52 files · ~6 hours reading · Levels:beginner →
advanced
Русский · English
Quick Start
brew install ollama # macOS
ollama run qwen3.5:4b # chat (~3.4 GB) — ready!
New to AI? → basics/ — start from zero, no terminal required.
Already experienced? → file catalog — find any topic in 10 seconds.
Sections
| Section | Description | Entry | Files | Level |
|---|---|---|---|---|
| Zero Level |
AI basics: terms, setup, hardware choice | basics/ |
9 | |
 Local Models |
Running, choosing, tuning and optimizing models | local-models/ |
11 | → |
| Architecture, patterns, frameworks, tutorials | agents/ |
17 | → |
|
| Coding, RAG, automation, writing | use-cases/ |
5 |  |
|
| Communities, courses, RU and EN materials | resources/ |
5 | → |
Looking for a specific file? Open catalog → — full list of all 52 files with descriptions.
Project Structure
awesome-ai-handbook/
│
├── README.md, README.ru.md ← navigation (EN + RU)
├── catalog.md, catalog.ru.md ← full file catalog
│
├── basics/ # 🟢 zero level
│ ├── README.md # learning paths
│ ├── what-is-ai.md # AI, ML, LLM — without math
│ ├── how-models-work.md # neural networks by analogy
│ ├── cloud-vs-local.md # ChatGPT vs local
│ ├── hardware-guide.md # RAM, VRAM, quantization
│ ├── glossary.md # 35 terms
│ ├── faq.md # 15+ common questions
│ ├── learning-path.md # 10 steps: chat → agent
│ ├── setup-windows.md # Windows installation
│ └── setup-linux.md # Linux installation
│
├── local-models/ # 🔵 local inference
│ ├── README.md # scenarios: beginner → pro
│ ├── getting-started.md # 🟢 full Mac setup guide
│ ├── running-models.md # from Ollama to HuggingFace
│ ├── models.md # choosing by task
│ ├── catalog.md # 50+ models with specs
│ ├── quantization.md # Q4, Q5, Q8 — compression
│ ├── memory-and-context.md # RAM, KV cache, context
│ ├── tools.md # engine comparison
│ ├── advanced-setup.md # 🔵 Modelfile, API, env
│ ├── troubleshooting.md # common issues
│ └── benchmarks/
│ └── apple-silicon.md # 🔵 tok/s on M1–M4
│
├── agents/ # 🤖 AI agents
│ ├── README.md # overview + minimal code
│ ├── ready-made.md # 🟢 existing agents catalog
│ ├── orchestrators.md # 🔵 orchestrators
│ ├── skills.md # 🟡 skills, MCP, plugins
│ ├── architecture.md # 🔵 agent architecture
│ ├── patterns.md # 🔵 ReAct, Multi-Agent
│ ├── frameworks.md # 🔵 LangGraph, CrewAI
│ ├── multi-agent.md # 🔵 communication
│ ├── memory.md # 🔵 long-term memory
│ ├── prompting.md # 🔵 system prompts
│ ├── ollama-for-agents.md # 🔵 tool calling
│ ├── safety.md # 🔵 guardrails
│ ├── evaluation.md # 🔵 testing
│ └── tutorials/
│ ├── README.md # tutorial index
│ ├── 01-first-agent.md # 🟢 first agent
│ ├── 02-agent-team.md # 🟡 agent team
│ └── 03-coding-agent.md # 🔴 coding agent
│
├── use-cases/ # 💼 applications
│ ├── README.md # cases overview
│ ├── coding.md # 🟡 Continue, Aider
│ ├── rag.md # 🟡 Open WebUI, ChromaDB
│ ├── automation.md # 🟡 n8n, Telegram bot
│ └── writing.md # 🟡 content pipeline
│
├── resources/ # 📖 communities & courses
│ ├── README.md # index
│ ├── ru.md # 🟢 Russian resources
│ ├── en.md # 🟡 English resources
│ ├── courses.md # 🟢🟡 free courses
│ └── communities.md # 🟢 Discord, Reddit
│
├── CONTRIBUTING.md # contributing guide
├── CODE_OF_CONDUCT.md # code of conduct
└── SECURITY.md # security policy
Contributing
Benchmarks, RU resources, tutorials, and fixes are welcome.
Details: CONTRIBUTING.md · Code of Conduct
License
Awesome AI Handbook — helping everyone explore AI, regardless of skill level or hardware.
