Capka

You hand Capka a task and some files, and it hands back the finished thing: a report, a cleaned-up spreadsheet, a converted document, a patch. It runs on your own server, so the work happens in an isolated Linux sandbox there, not on the laptop of whoever asked.

I wanted something I could run myself, connect to my own models and API keys, and share with a small team. Not another hosted chat product locked to one vendor.

I have followed LLMs and agent tools since the start, and tried a lot of them in real work. A lot of them still feel like chat wrappers, are hard to self-host, or are unpleasant to use every day.

Capka is where I put the parts I actually wanted: files, tools, code execution, durable tasks, isolated workspaces, MCP, and a UI that does not fight you.

The workflow is intentionally simple:

1. You upload files, or the agent downloads or creates them during the chat
2. Each chat (or each project, for chats inside one) gets its own Linux sandbox and file storage
3. The agent works inside that workspace and returns files you can use.

Nothing depends on your browser staying open. Every turn is a queued job on the server, saved after each step, so a closed tab, a dropped connection, or a restart of Capka itself resumes where it left off instead of losing the reply.

This is a solo project, built seriously. I am trying to make the AI tool I actually want to use.

There is a longer walkthrough on the website, or you can try the live demo and hand it a real task right now.

At a glance

What you get back	Files: reports, spreadsheets, PDFs, converted documents, patches
Where the work happens	An isolated Linux sandbox on your server, one per chat or project
Runs on	Your Linux server with Docker
Files	What people upload, plus what the agent downloads or creates during the chat
Models	Cloud providers or local models through Ollama
Users	Multi-user, registration closed by default
Admin	Users, auth, providers, MCP, skills, policies, security, usage, updates

What People Use It For

The tasks where the useful output is not a message:

• reports and spreadsheet work
• PDFs and document conversion
• research over uploaded or downloaded files
• file organization and cleanup
• repetitive office jobs nobody wants to do by hand
• small coding and debugging work
• workflows through MCP tools and connectors

Is Capka for you?

Reach for Capka if:

• your files should not leave your own infrastructure
• the people using it are not developers, and should not have to think about providers or keys
• you would rather choose models and pay for tokens than pay a per-seat subscription
• you have a small Linux server, or do not mind renting one

Look elsewhere if:

• you just want to chat with a model and never touch files — a plain chat app is simpler
• nobody wants to run and maintain a server — hosted products exist for a reason
• you need vendor support with an SLA — Capka is open source, and support lives in GitHub issues

For teams

One person sets Capka up: connects a provider key, picks which models everyone may use, decides who gets in. After that nobody else has to know what a provider is. That split runs through the whole product, not just the setup screen.

Starting alone is the normal way in. Install it for yourself, use it on your own work, and invite people to the same server when you are ready.

Admins get one place to manage the instance:

Area	What admins control
Users	roles, pending approvals, registration mode
Models	provider keys, default models, local or cloud providers
Tools	MCP connectors, skills, marketplace plugins
Safety	allow, ask, deny policies, audit log, sandbox internet access
Ops	usage, billing status, updates, Telegram bot setup

Each chat, or each project for chats inside one, gets its own sandbox and file storage, so team members can work on separate tasks without sharing one messy workspace.

How It Runs

Service	Purpose
platform	Next.js app, APIs, agent loop, and worker
postgres	Database and task queue
sandbox-controller	Creates and removes per-chat and per-project containers
socket-proxy	Gives the controller restricted Docker API access
sandbox	Execution image used by agent sessions

Sandboxes include Python, Node, FFmpeg, ImageMagick, LibreOffice, pandoc (PDF via typst or weasyprint), Playwright with Chromium, OCR tooling, and other common utilities. There is no Java or LaTeX.

Run Locally

npm run docker:dev

Open http://localhost:3000. If no admin account exists, Capka redirects you to setup. After that, add a provider key in Settings -> Providers.

Deploy

On a fresh Linux server, one command installs Docker (if needed), fetches Capka, generates secrets, and brings the stack up:

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

It asks how people should reach Capka. No domain? Just press Enter — you get a free HTTPS address with a real certificate (https://<your-ip>.sslip.io). Have a domain? Type it and Caddy provisions HTTPS for it automatically. Either way the installer waits until the app answers and then prints the address to open.

Already own a domain and want to skip the prompt:

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

This is the beginning of the README. Read the rest at the original. Read the full README ↗