Frequently asked questions¶
The basics¶
What is Code Akos?¶
Code Akos is a self-hosted error tracker that works with Sentry SDKs. It receives the errors your app reports, groups repeats, opens a GitHub issue for each new one and has an AI model attempt a fix, which it opens as a pull request for you to review. It runs as a desktop app on macOS, Windows and Linux, or as a single Node.js process on a server.
Is Code Akos a replacement for Sentry?¶
For error tracking, yes. Code Akos accepts events from Sentry SDKs, so switching only means changing the DSN in your app. It does not replace the rest of Sentry: there is no performance tracing, session replay, alerting or team accounts. See the comparison of Sentry alternatives.
Do I need to change my code?¶
Only the dsn setting in your Sentry SDK setup. If your app does not use Sentry yet, you install the official Sentry SDK and add a few lines; the getting started guide has the code for Python, Node.js and the browser.
Which languages and SDKs are supported?¶
Code Akos implements Sentry's standard store and envelope endpoints, which all official Sentry SDKs use. The Python SDK has been tested end to end. The dashboard's setup guide includes ready-made code for Python, Node.js and the browser. Other SDKs, such as those for Go, Ruby or PHP, use the same endpoints and are expected to work but have not been tested yet.
Does Code Akos work with GitLab or Bitbucket?¶
No. Code Akos files issues and opens pull requests on GitHub only. GitHub Enterprise Server works by pointing Code Akos at your server's API address (ORCH_GITHUB_API_URL in the configuration reference).
Cost and licensing¶
Is Code Akos free?¶
Yes. Code Akos is free to download, use and self-host, including at work. If you choose DeepSeek or Anthropic as the model, you pay those providers for what you use. With Ollama, the model runs on your computer at no cost.
Is Code Akos open source?¶
Code Akos is source-available under the Functional Source License (FSL-1.1-ALv2). You can read, change and self-host the code freely; the one restriction is that you cannot use it to offer a competing commercial product. Each release automatically becomes Apache 2.0 licensed, a standard open source license, two years after it is published.
How much do AI fixes cost with a paid API?¶
Each fix attempt uses at most 20 model calls, and an issue that keeps failing is tried at most 3 times before Code Akos stops on its own. Skipped attempts and successful fixes also use calls. The default hosted models, deepseek-flash and claude-haiku-4-5, are low-cost models chosen for this kind of short task. To pay nothing, use Ollama.
Privacy and security¶
Does my code leave my computer?¶
Not if you use Ollama on the same computer. With DeepSeek or Anthropic, the error details and the source files the model reads are sent to that provider. In every case, Code Akos talks to GitHub to file issues and open pull requests. What leaves your machine lists exactly what is sent.
Where are my GitHub tokens stored?¶
On your computer, in Code Akos's data folder, encrypted with AES-256-GCM. The key is stored next to them with permissions only you can read, so protect the folder as you would your SSH keys. Tokens are never sent to the browser.
Can Code Akos merge code or push to my main branch?¶
No. Code Akos pushes each fix to its own branch, code-akos/issue-<number>, and opens a pull request. Merging is always up to you.
Can the model run commands on my computer?¶
No. The model can only read files, list folders, search the code and edit files in a temporary copy of your repository. The only command Code Akos runs is the check command you set for the project, such as npm test.
AI fixes¶
How is Code Akos different from Sentry Seer?¶
Both find the cause of an error and can open a fix as a pull request. Seer runs in Sentry's cloud and is a paid add-on. Code Akos runs on your own computer, works with a model you choose, including a free local one, and also runs your tests before and after each change. See Code Akos resolver vs Sentry Seer.
How good are the fixes?¶
The success rate has not been measured yet, and it depends heavily on the model. The resolver is told to make small, focused changes and to skip when it is not sure, and your check command shows whether the tests still pass. Review every pull request as you would one from a new contributor.
Which model should I use?¶
Start with qwen2.5-coder:7b through Ollama: it is free, private and good enough to see how Code Akos works. For better fixes, add DeepSeek or Anthropic as a second provider. Code Akos uses providers in the order you set and falls back when one fails.
Running Code Akos¶
Can I run Code Akos on a server?¶
Yes. Run it from source with Node.js 24 or newer and git; see installation. To receive errors from other machines, open the ingest port to the network, set an access key, and put a reverse proxy with HTTPS in front of it.
Can several people use one Code Akos?¶
Not yet. Code Akos has a single login and is designed for one person. The GitHub issues and pull requests it creates are visible to your whole team as usual.
Does Code Akos update itself?¶
It tells you, but you install it. The desktop app checks GitHub for a new version at startup and once a day, and offers to download it. You then install it over the old app, and your settings and data are kept. Fully automatic updates on macOS need a signed and notarized app, which Code Akos does not have yet. See updating.
Why does my Mac or Windows warn me when I open Code Akos?¶
The builds are not signed with a paid developer certificate yet. macOS asks you to allow the app once in System Settings › Privacy & Security, and Windows SmartScreen asks you to click More info › Run anyway. The installation guide shows both.