git404hub

what is atuin-ai-server fr?

atuinsh/atuin-ai-server — explained in plain English

Analysis updated 2026-05-18

53ElixirAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

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.

vibe map

mindmap
  root((atuin-ai-server))
    What it does
      Self hosted AI chat backend
      Works with any OpenAI style endpoint
    Tech stack
      Elixir
      Docker
      Gleam
    Use cases
      Local model chat
      Web search tool
      Private hosting
    Audience
      Developers
      Self-hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run Atuin's AI chat feature against a local model server like Ollama without sending data to a hosted service

VIBE 2

Connect Atuin's command line chat to a self hosted or custom OpenAI-compatible endpoint

VIBE 3

Enable web search or webpage scraping tools for the AI chat by adding API keys

VIBE 4

Self host the chat backend to avoid account requirements or usage limits

what's the stack?

ElixirErlangGleamDocker

how it stacks up fr

atuinsh/atuin-ai-serverentgriff/ezraedgurgel/riex
Stars532623
LanguageElixirElixirElixir
Last pushed2015-07-08
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an OpenAI-compatible model endpoint (local or cloud) that supports tool calling.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Show me how to run atuin-ai-server with Docker pointed at a local Ollama instance
prompt 2
Help me write a config.toml that connects atuin-ai-server to an OpenRouter model
prompt 3
Explain how to require an auth token so my atuin-ai-server isn't open to anyone
prompt 4
What does it mean that the model must support tool calling to work with this server

Frequently asked questions

what is atuin-ai-server fr?

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.

What language is atuin-ai-server written in?

Mainly Elixir. The stack also includes Elixir, Erlang, Gleam.

What license does atuin-ai-server use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is atuin-ai-server to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is atuin-ai-server for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.