Metadata-Version: 2.4
Name: codex-rag-system
Version: 0.1.0
Summary: Local-first RAG, MCP, HTTP, and Obsidian workflow system
Author: RAG System contributors
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: <3.15,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.136.3
Requires-Dist: starlette>=1.3.1
Requires-Dist: uvicorn>=0.48.0
Requires-Dist: pypdf
Requires-Dist: python-docx
Provides-Extra: docs
Requires-Dist: pypdf; extra == "docs"
Requires-Dist: python-docx; extra == "docs"
Provides-Extra: dev
Requires-Dist: fastapi>=0.136.3; extra == "dev"
Requires-Dist: hypothesis>=6.0; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: starlette>=1.3.1; extra == "dev"
Requires-Dist: uvicorn>=0.48.0; extra == "dev"
Provides-Extra: http
Requires-Dist: fastapi>=0.136.3; extra == "http"
Requires-Dist: starlette>=1.3.1; extra == "http"
Requires-Dist: uvicorn>=0.48.0; extra == "http"
Provides-Extra: security
Requires-Dist: bandit==1.9.4; extra == "security"
Requires-Dist: msgpack>=1.2.1; extra == "security"
Requires-Dist: pip-audit==2.10.0; extra == "security"
Dynamic: license-file

# RAG System

Локальный поиск по документам через MCP для Codex и Claude Code. Данные и индекс
хранятся на вашем компьютере. Для эмбеддингов используется локальная Ollama;
Obsidian можно подключить позже.

## Быстрый старт на Windows

Нужны Python 3.11–3.14, [pipx](https://pipx.pypa.io/stable/installation/) и
[Ollama](https://ollama.com/download/windows). Установите пакет и модель:

```powershell
pipx install codex-rag-system
ollama pull nomic-embed-text
rag-system init
```

Мастер создаст папку `%LOCALAPPDATA%\RAG System\source_files\Documents`,
проверит Ollama и предложит подключить MCP к Codex и Claude Code. Он не
устанавливает Ollama автоматически. Поместите в `Documents` файлы `.md`, `.txt`,
`.pdf` или `.docx`, затем выполните:

```powershell
rag-system index
rag-system doctor
```

После перезапуска клиента попросите Codex или Claude Code найти сведения в
локальных документах. MCP-инструмент `rag_context` возвращает выдержки и пути
источников. Для ручного подключения клиента используйте
`rag-system init --client codex`, `--client claude` или `--client both`.

## Дополнительные команды

```powershell
rag-system init --obsidian-active "C:\path\to\ObsidianVault\Active"
rag-system index --collection obsidian
rag-system serve
pipx upgrade codex-rag-system
pipx uninstall codex-rag-system
```

`rag-system serve` открывает локальный HTTP API и dashboard на
`http://127.0.0.1:8000`. При удалении пакета локальные документы и индекс
остаются в `%LOCALAPPDATA%\RAG System`.

Подробная [установка и настройка](docs/external-install.md),
[устранение неполадок](docs/troubleshooting.md) и
[справочник разработчика](docs/developer-reference.md) находятся в `docs/`.
[Порядок выпуска](docs/releasing.md) предназначен для сопровождающих.
Инструкции для [участников разработки](CONTRIBUTING.md) и
[сообщений об уязвимостях](SECURITY.md) находятся в корне репозитория.

Исходный код проекта размещён в приватном GitHub-репозитории. Пакет PyPI,
когда он опубликован, доступен публично по лицензии MIT.
