[ANN] Tachikoma.jl — A terminal UI framework for Julia

Package Announcements
, ,
1

Tachikoma.jl is a pure-Julia framework for building rich, interactive terminal applications. It uses an Elm-inspired Model/update!/view architecture with a 60fps event loop, double-buffered rendering, 30+ composable widgets, and built-in recording/export.

GitHub: github.com/kahliburke/Tachikoma.jl
Docs: kahliburke.github.io/Tachikoma.jl

hero demo

Install

using Pkg
Pkg.add("Tachikoma")

Requires Julia 1.12+.

What’s in the box

Architecture — Define a Model struct, write update! for events, write view to render. The framework handles the event loop, frame pacing, and diff-based terminal output.

30+ widgets — Text inputs, text areas, code editor with syntax highlighting, data tables with column resize/sort, forms with validation, tree views, charts, sparklines, calendars, modals, dropdowns, markdown viewer, and more.

Constraint layouts — Fixed, Fill, Percent, Min, Max, and Ratio constraints with nested horizontal/vertical splits. Draggable resizable pane borders with layout persistence via Preferences.jl.

Animation — Tweens with 10 easing functions, physics-based springs with retarget!, timeline composition (sequence, stagger, parallel), and organic effects (pulse, breathe, shimmer, jitter, flicker, drift).

Graphics — Three rendering backends: Braille dots (2x4 per cell), quadrant blocks (2x2), and pixel rendering via Kitty or sixel protocol (16x32 per cell). Vector drawing API with lines, arcs, circles, and filled shapes.

11 themes — Cyberpunk, retro, and classic palettes (Kokaku, Esper, Motoko, Kaneda, Neuromancer, Catppuccin, Solarized, Dracula, Outrun, Zenburn, Iceberg) with hot-swap switching at runtime.

Async tasks — spawn_task! / TaskQueue for background work that delivers results back to the main thread as events, preserving the single-threaded Elm architecture. Cancel tokens, timers, and repeat scheduling.

Recording & export — Live recording via Ctrl+R, headless record_app() / record_widget() for CI/docs, native .tach format with Zstd compression, export to SVG and GIF.

Testing — TestBackend for headless widget rendering with char_at(), style_at(), row_text(), find_text() inspection APIs.

Quick example

A Game of Life in ~30 lines:

using Tachikoma

@kwdef mutable struct Life <: Model
    quit::Bool = false
    grid::Matrix{Bool} = rand(24, 80) .< 0.25
end

Tachikoma.should_quit(m::Life) = m.quit
function Tachikoma.update!(m::Life, e::KeyEvent)
    e.key == :escape && (m.quit = true)
end

function Tachikoma.view(m::Life, f::Frame)
    h, w = size(m.grid)
    g = m.grid
    nc = [sum(g[mod1(i+di,h), mod1(j+dj,w)]
          for di in -1:1, dj in -1:1) - g[i,j]
          for i in 1:h, j in 1:w]
    g .= (nc .== 3) .| (g .& (nc .== 2))
    a, buf = f.area, f.buffer
    for i in 1:min(h, a.height), j in 1:min(w, a.width)
        g[i,j] || continue
        set_char!(buf, a.x+j-1, a.y+i-1, '█',
            tstyle([:primary,:accent,:success,:warning,:error][clamp(nc[i,j],1,5)]))
    end
end

app(Life())

Gallery
Dashboard Form with Validation
dashboard form
Animation Showcase Todo List
anim todo
GitHub PR Viewer Animated Backgrounds
prs dotwave

Comparisons

Tachikoma is designed full-screen interactive applications with their own event loop, like what you’d build with Textual (Python), Ratatui (Rust), or Bubbletea (Go). If you want to build a dashboard, data explorer, or game that takes over the terminal, that’s what Tachikoma is for.

Tutorials

The docs include step-by-step tutorials that build complete apps:

  • Getting Started — A dice game covering model, input, layout, and widgets
  • Dashboard — Multi-panel layout with charts, tables, and live data
  • Todo List — CRUD app with forms, validation, and modal dialogs
  • GitHub PRs — Async data fetching with DataTable and markdown rendering
  • Animation Showcase — Tweens, springs, timelines, and organic effects

Feedback, issues, and contributions welcome at github.com/kahliburke/Tachikoma.jl.

27 Likes