atuinsh/atuin-ai-server — explained in plain English
Analysis updated 2026-05-18
Run Atuin's AI chat feature against a local model server like Ollama without sending data to a hosted service
Connect Atuin's command line chat to a self hosted or custom OpenAI-compatible endpoint
Enable web search or webpage scraping tools for the AI chat by adding API keys
Self host the chat backend to avoid account requirements or usage limits
| atuinsh/atuin-ai-server | entgriff/ezra | edgurgel/riex | |
|---|---|---|---|
| Stars | 53 | 26 | 23 |
| Language | Elixir | Elixir | Elixir |
| Last pushed | — | — | 2015-07-08 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 3/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an OpenAI-compatible model endpoint (local or cloud) that supports tool calling.
Atuin AI Server is a self hosted backend for Atuin's AI chat feature, which normally runs as a hosted service the Atuin team operates. This project lets someone run that same chat engine themselves, pointed at any AI model server that speaks the common OpenAI style chat format, including popular local options like Ollama, LM Studio, and llama.cpp, or a compatible cloud API. Running it is meant to be simple. It ships as a Docker image, so a user copies an example configuration file, edits it to point at their chosen model server, and starts the container with one command. It can also be built and run directly from source code for people who prefer not to use Docker, using the Elixir and Erlang programming languages and the Gleam tool that the project is built with. Configuration lives in a single file listing the server's port, the address of the model backend, and one or more named models the Atuin command line tool can choose from. Whatever model is chosen must support what is called tool calling, meaning the model can request that certain actions be performed on its behalf, since Atuin's chat feature relies on this at every turn. The server also supports a few optional built in tools of its own, letting the AI search the web or scrape a webpage, each of which only turns on if the matching service key is provided in the configuration. Once running, a user points their local Atuin configuration file at this server's address, and their command line chat sessions run against the model server they chose instead of Atuin's hosted default. The project intentionally keeps no accounts, no stored history, and no usage limits, since it is meant purely as a private bridge between the Atuin tool and whatever model infrastructure someone already has. It is released under the Apache 2.0 license, meaning it can be freely used, modified, and redistributed as long as the license notice is kept.
A self hosted server that lets Atuin's AI chat feature run against your own local or cloud AI model instead of the hosted service.
Mainly Elixir. The stack also includes Elixir, Erlang, Gleam.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.