# OpenClaude + Local LLM Handbook

Репозиторий — **набор практических руководств** по запуску [OpenClaude](https://github.com/Gitlawb/openclaude) на своём железе, работе с **локальными и облачными** моделями, **MCP** и **RAG**, плюс пример минимального стека в `docs/rag-mcp-starter/`.

Это **не** исходники OpenClaude: CLI ставится отдельно через npm (`@gitlawb/openclaude`). Сами гайды и скрипты вы клонируете отсюда.

## Зачем этот репозиторий

- собрать **понятный путь от терминов до рабочего стенда** без пролистывания одного гигантского файла;
- держать **детали в `docs/`**, а в корне — только обзор и входные точки.

## С чего начать

1. Коротко: **что это за проект vs CLI** → [docs/repository-and-cli.md](docs/repository-and-cli.md)  
2. Полный указатель «**от простого к сложному**» → **[docs/README.md](docs/README.md)**  
3. План по дням → [docs/START-HERE.md](docs/START-HERE.md)  
4. Быстрый практический прогон (Ubuntu ~30 мин) → [docs/quickstart-30min.md](docs/quickstart-30min.md)

## Клонирование

```bash
git clone https://github.com/PTah/openclaude-LLM-local.git
cd openclaude-LLM-local
```

Если используете другой remote (fork), подставьте свой URL со страницы репозитория на GitHub.

## Частые точки входа по темам

| Тема | Документ |
|------|-----------|
| Термины (LLM, MCP, провайдеры) | [docs/concepts-and-terms.md](docs/concepts-and-terms.md) |
| Установка CLI, Ollama, профили | [docs/install-openclaude-cli.md](docs/install-openclaude-cli.md) |
| Локальные модели и `ollama` | [docs/local-llm-ollama.md](docs/local-llm-ollama.md) |
| RAG и MCP, чек-лист подключения | [docs/rag-mcp-stack.md](docs/rag-mcp-stack.md) |
| Пример стека (скрипты + compose) | [docs/rag-mcp-starter/](docs/rag-mcp-starter/) |
| GitHub / PAT / SSH | [docs/github-auth-remotes.md](docs/github-auth-remotes.md) |
| Железо под три бюджета | [docs/hardware-budgets.md](docs/hardware-budgets.md) |

Остальные файлы перечислены в **[docs/README.md](docs/README.md)**.