whatisgithub

What is haru?

arkorlab/haru — explained in plain English

Analysis updated 2026-05-18

7TypeScriptAudience · ops devopsComplexity · 5/5Setup · hard

In one sentence

Infrastructure software that manages fleets of GPU servers running self-hosted AI models, automatically failing over to a backup server while using its spare capacity for background training.

Mindmap

mindmap
  root((Haru))
    What it does
      GPU fleet management
      Active standby failover
      Background LoRA training
    Tech stack
      TypeScript
      SkyPilot
      vLLM
      Postgres and Neon
    Use cases
      Self hosted LLM hosting
      High availability inference
      Multi cloud GPU orchestration
    Audience
      Infrastructure engineers
      ML platform teams

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 build with it?

USE CASE 1

Run self-hosted LLM inference with automatic failover between GPU regions or providers.

USE CASE 2

Keep standby GPU capacity productive by running background model fine tuning on it.

USE CASE 3

Serve OpenAI-compatible chat completions from a fleet of self-hosted models.

USE CASE 4

Coordinate GPU provisioning across multiple clouds without hardcoding provider logic.

What is it built with?

TypeScriptSkyPilotSkyServevLLMPostgreSQLNeon

How does it compare?

arkorlab/haruadguardteam/ruleseditorartickc/opencode-telegram-bot
Stars777
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-01
MaintenanceActive
Setup difficultyhardeasymoderate
Complexity5/52/53/5
Audienceops devopsdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Neon or Postgres database, cloud GPU accounts wired through SkyPilot, and API tokens configured before first use.

The README does not state a license.

So what is it?

Haru is infrastructure software for companies that run their own large language models on GPU servers instead of relying entirely on outside AI providers. It sits above the raw cloud provisioning tools and gives a product's backend one small, consistent interface for managing a fleet of GPUs, no matter which cloud provider or region those GPUs actually live in. Its main job, at least for now, is keeping AI inference available even when a server or region goes down, while wasting as little GPU capacity as possible. One GPU domain is active and actually answers requests. A second, standby domain keeps the same AI model loaded but puts the inference server into a low power sleep state, moving the model's weights out of GPU memory into regular system memory. That freed up GPU memory is then used to run a lower priority model fine tuning job in the background while the standby domain waits. If the active domain fails, Haru wakes the standby domain, which is fast since the model just needs to move back from system memory rather than reloading from disk, stops the background training job, runs a quick test request against every model to confirm things work, and then switches which domain receives real traffic. If anything goes wrong partway through that process, live traffic never gets rerouted to a domain that is not actually ready. Haru is built as a layer on top of two existing tools, SkyPilot and SkyServe, which handle the lower level work of provisioning cloud GPU machines and running inference services across providers. Haru itself does not talk to cloud provider APIs directly. The project stores its state in a Postgres database, using Neon as its primary supported provider, and every change of state happens as a single database operation so that competing background processes cannot corrupt it. The codebase is organized as several packages: shared data schemas, the core decision making logic, the database layer, provisioning drivers for SkyPilot and SkyServe, a control server with an OpenAI-compatible chat API, and a supervisor program that runs on each GPU machine. This is backend infrastructure meant for teams already running self-hosted AI models, not an end-user application. The README does not state a license.

Copy-paste prompts

Prompt 1
Explain how Haru's active and standby domains work together to avoid wasting idle GPUs.
Prompt 2
Walk me through setting up Haru's Postgres database with Neon and running the seed script.
Prompt 3
What happens if a promotion from standby to active fails partway through in Haru?
Prompt 4
Help me call Haru's OpenAI-compatible chat completions endpoint for a specific fleet.

Frequently asked questions

What is haru?

Infrastructure software that manages fleets of GPU servers running self-hosted AI models, automatically failing over to a backup server while using its spare capacity for background training.

What language is haru written in?

Mainly TypeScript. The stack also includes TypeScript, SkyPilot, SkyServe.

What license does haru use?

The README does not state a license.

How hard is haru to set up?

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

Who is haru for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.