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	→
AI Agents	Architecture, patterns, frameworks, tutorials	agents/	17	→
Use Cases	Coding, RAG, automation, writing	use-cases/	5
Resources	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

MIT

Awesome AI Handbook — helping everyone explore AI, regardless of skill level or hardware.