git404hub

what is homerail fr?

xiaotianfotos/homerail — explained in plain English

Analysis updated 2026-05-18

657TypeScriptAudience · developerComplexity · 4/5Setup · hard

tl;dr

A TypeScript runtime that turns AI agent chats into structured, replayable workflows you can run by voice, text, or command line on your own home server.

vibe map

mindmap
  root((HomeRail))
    What it does
      Runs agent workflows as a graph
      Records every handoff
      Replayable runs
      Voice and text input
    Tech stack
      TypeScript
      Node.js
      Docker
      Claude Agent SDK
    Use cases
      Automate home server tasks
      Build reusable agent workflows
      Voice control an agent system
      Inspect and replay agent runs
    Audience
      Developers
      Homelab enthusiasts
      AI agent builders
    Setup
      Install Node and Docker
      Build from source
      Run hr start command

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

Turn a one-off AI agent conversation into a reusable, inspectable workflow.

VIBE 2

Run a home server automation system controlled by voice.

VIBE 3

Build a graph of multiple AI agents that hand off tasks to each other.

VIBE 4

Replay and score past agent runs to see what happened at each step.

what's the stack?

TypeScriptNode.jsDockerClaude Agent SDK

how it stacks up fr

xiaotianfotos/homeraildenoland/denokvuditakhourii/adhd
Stars657652619
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-11
MaintenanceMaintained
Setup difficultyhardmoderateeasy
Complexity4/53/53/5
Audiencedeveloperdeveloperdeveloper

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

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Node.js 20+, Docker for worker containers, and a Claude Agent SDK compatible model endpoint for live runs.

The README does not state a license for this project.

in plain english

HomeRail is a TypeScript runtime that turns quick, throwaway AI agent chats into structured, repeatable workflows you can inspect and rerun. The name reflects the idea behind it: it is meant to run on your own homelab, NAS, or home server, and work flows step by step along a graph of connected agents rather than getting lost inside one long chat conversation. The main goal is to ask as little as possible of the person using it, since attention is treated as the scarcest resource in any home automation setup. The project is built around three main ideas. Voice is the preferred way to interact with it, since speaking takes less effort than typing, though a text option is always available too. Instead of showing raw logs or technical data, the system tries to generate a simple interface for whatever is happening at the moment, though this generated interface feature is still early and evolving. Underneath both of these sits a directed graph engine that runs multiple AI agents through explicit steps, where every handoff between agents is recorded and can be replayed later, unlike a normal chat which cannot be inspected afterward. What currently works includes the graph execution engine itself, which is the most mature part, along with a command line tool called hr for starting the system, checking its health, running workflows, and reviewing results. There is also an early voice interface with speech recognition and text to speech, defaulting to Chinese, and a Docker based worker system that runs each step of a workflow inside its own isolated container. To run HomeRail you need Node.js 20 or newer, Docker, and access to a Claude Agent SDK compatible AI model. The README is written so that a coding agent like Claude Code can read it directly and follow the setup steps itself, including installing dependencies, building the project, and running a first test workflow without needing a live AI model connected yet.

prompts (copy fr)

prompt 1
Help me install HomeRail and run the two-node offline template on my machine.
prompt 2
Explain what the hr doctor command checks before I start a live run.
prompt 3
Walk me through creating my own DAG workflow template for HomeRail.
prompt 4
Show me how to set up the voice surface so I can talk to the agent instead of typing.
prompt 5
Explain how Docker Worker containers isolate each step of a HomeRail run.

Frequently asked questions

what is homerail fr?

A TypeScript runtime that turns AI agent chats into structured, replayable workflows you can run by voice, text, or command line on your own home server.

What language is homerail written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

What license does homerail use?

The README does not state a license for this project.

How hard is homerail to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is homerail for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.