git404hub

what is zoraos fr?

cbaird26/zoraos — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

A local-first, prototype operating system layer for AI agents that routes tasks across multiple model providers, tools, and a memory store.

vibe map

mindmap
  root((ZoraOS))
    What it does
      Local-first AI OS
      Task planning and routing
      Multi-provider models
      Memory and storage
    Tech stack
      Python
      FastAPI
      Next.js
      Docker
    Use cases
      Research automation
      Coding agents
      Knowledge management
    Audience
      AI developers
      Prototype builders

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

Route AI agent tasks to different named agents such as Research, Developer, or Writer.

VIBE 2

Run local, bounded automated research cycles with strict daily task and token limits.

VIBE 3

Store and query agent memory using a combined vector store, knowledge graph, and document store.

what's the stack?

PythonFastAPINext.jsDockerPostgreSQL

how it stacks up fr

cbaird26/zoraos0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

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

how do i run it?

Difficulty · hard time til it works · 1h+

Requires API keys for at least one model provider, Docker or manual startup, and separate UI setup.

License terms are not stated in the README.

in plain english

ZoraOS describes itself as a local-first operating system for AI workflows, aimed at research, coding, and knowledge management tasks, rather than a single chatbot. Requests move through a frontend built with Next.js, into a FastAPI gateway, then through a planner that breaks a goal into tasks, a router that picks which model or provider handles each task, and out to a set of agents and tools that do the actual work. The project ships with several named agents, including Research, Developer, Writer, and Knowledge, along with tools for the filesystem, Git, web search, running Python, and reading PDFs. It stores information using a vector store, a knowledge graph, and a document store, described together as its memory layer. A scheduler is present as a scaffold for cron-style workflows but is not yet a working executor, and a separate research daemon can run bounded research cycles locally, but only when an operator starts it directly with an exact goal, since it never launches automatically with the API. The system is designed to work with many model providers rather than being tied to one, listing OpenAI, DeepSeek, Kimi, Qwen, Anthropic, Gemini, Grok, and Ollama as supported options. The README also describes an optional multi-machine setup, splitting orchestration, inference, automation, and memory storage across separate machines. The maintainer is explicit that this is a prototype: unknown tools are denied by default, control of third-party desktops is disabled, the API is local-only, and the research daemon defaults to local models with strict daily limits on tasks, tool calls, and tokens. Getting started involves copying an example environment file, adding API keys, and running either Docker Compose or a startup script, with a separate local development server for the dashboard UI.

prompts (copy fr)

prompt 1
Design a FastAPI gateway that routes requests to different AI model providers based on task type.
prompt 2
Write a planner module that breaks a high-level goal into a sequence of tasks for autonomous agents.
prompt 3
How do I set daily limits on tasks, tool calls, and tokens for a locally running automation daemon?
prompt 4
Build a Next.js dashboard that shows live plans, budgets, and governance state for an agent system.

Frequently asked questions

what is zoraos fr?

A local-first, prototype operating system layer for AI agents that routes tasks across multiple model providers, tools, and a memory store.

What language is zoraos written in?

Mainly Python. The stack also includes Python, FastAPI, Next.js.

What license does zoraos use?

License terms are not stated in the README.

How hard is zoraos to set up?

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

Who is zoraos for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.