# Capka

> Capka — self-hosted платформа для ШІ-агентів, яка повертає файли, а не відповіді в чаті. Ви прикріплюєте таблиці, документи, архіви чи код і описуєте потрібний результат; агент працює в ізольованій Linux-пісочниці й повертає звіт, чисті дані, конвертований файл або патч.

Capka працює на вашому власному Linux-сервері з Docker — для старту вистачить 2 GB RAM і 20 GB диска — і використовує ваші ключі до моделей (Anthropic, OpenRouter, будь-який OpenAI-сумісний API) або локальні моделі через Ollama. Кожен чат отримує власну Linux-пісочницю з Python, Node, LibreOffice, FFmpeg, Playwright і OCR, а завдання продовжують виконуватися на сервері після закриття вкладки.

Один інстанс обслуговує багатьох людей: файли й чати лишаються приватними для кожного, а адміністратор бачить ролі й витрати токенів, а не чуже листування. Уся платформа доступна також через Telegram. Розширюється скілами, сумісними з Anthropic, конекторами MCP і наборами з маркетплейсу.

Хмари Capka не існує, підписки за користувача теж. Ви тримаєте сервер і платите провайдеру моделі напряму. Код відкритий за ліцензією AGPL-3.0.

Чим відрізняється від сусідів по категорії: Claude Cowork працює у своїй хмарі й лише з моделями Anthropic; OpenClaw — персональний асистент, чия документація називає спільний доступ зручністю, а не межею безпеки; Suna запускає справжні пісочниці, але потребує поруч хмарних Supabase, Daytona і Composio. Capka зроблена для команди на одному невеликому сервері.

Встановлення:

```
curl -fsSL https://raw.githubusercontent.com/LyoSU/capka/master/install.sh | sh
```

## Документація

- [Сторінка українською](https://capka.app/uk/): що робить Capka, кому підходить і чим відрізняється від Claude Cowork, OpenClaw, Suna, Open WebUI та Onyx
- [Landing page in English](https://capka.app/): та сама сторінка англійською
- [Технічна документація](https://capka.app/uk/docs/): огляд та індекс документації
- [Встановлення](https://capka.app/uk/docs/installation/): вимоги, однорядкове розгортання, перший запуск і оновлення
- [Налаштування](https://capka.app/uk/docs/configuration/): доступ, сховище, ключі моделей, політики та конектори
- [Змінні середовища](https://capka.app/uk/docs/environment/): усі production secrets, routing, sandbox, retention, worker, MCP і telemetry settings
- [Моделі](https://capka.app/uk/docs/models/): Anthropic, OpenRouter, OpenAI-сумісні endpoint та Ollama
- [Пісочниця](https://capka.app/uk/docs/sandbox/): окремі Linux-контейнери, інструменти, ліміти й посилення захисту
- [Файли та інструменти](https://capka.app/uk/docs/files/): постійні workspace, Python, Node.js, LibreOffice, FFmpeg, OCR та Playwright
- [Безпека](https://capka.app/uk/docs/security/): ізоляція, приватність, дозволи, мережа, gVisor і rootless Docker
- [Адміністрування](https://capka.app/uk/docs/admin/): користувачі, ролі, моделі, політики, аудит і витрати
- [Усунення проблем](https://capka.app/uk/docs/troubleshooting/): діагностика інсталяції, моделей і пісочниць
- [Повна документація одним файлом](https://capka.app/uk/llms-full.txt): об'єднаний Markdown для пошуку й офлайн-контексту
- [Репозиторій](https://github.com/LyoSU/capka): код, задачі й релізи
- [Скрипт встановлення](https://github.com/LyoSU/capka/blob/master/install.sh): те, що виконує команда встановлення
- [Нотатки про безпеку](https://github.com/LyoSU/capka/blob/master/SECURITY.md): ізоляція пісочниці й посилення через gVisor або rootless Docker
- [Ліцензія](https://github.com/LyoSU/capka/blob/master/LICENSE): AGPL-3.0

## Архітектура та ізоляція

Стек містить Next.js-платформу й worker, PostgreSQL-чергу задач, sandbox controller, обмежений проксі до Docker socket та образ пісочниці. Код агента працює в окремому контейнері з `no-new-privileges`, скинутими Linux capabilities, лімітами ресурсів і командами від uid 1000. Сесія монтує лише каталоги свого користувача. На свіжому інстансі вихід пісочниць у мережу вимкнений до явного дозволу адміністратора; його можна жорстко заборонити або обмежити allowlist. Для недовіреного multi-tenant використання документація радить gVisor разом із rootless Docker.

## Додатково

- [Демо-інстанс](https://demo.capka.app/): хостить автор, потрібен обліковий запис