gitwtfhub

wtf is raytsystem-public-os?

romarayt/raytsystem-public-os — explained in plain English

Analysis updated 2026-05-18

80PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A local-first, self-hosted workspace giving one person or a small team a command center for documents, tasks, and AI agent workflows.

Mindmap

mindmap
  root((repo))
    What it does
      Local command center
      Task and doc management
      Agent skill catalog
    Tech stack
      Python
      uv
      Node.js
    Use cases
      Private knowledge base
      Evidence backed queries
      Agent driven start
    Audience
      Developers
      Small 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

Why would anyone build with this?

REASON 1

Run a private, local-only command center for your tasks, documents, and agent runs.

REASON 2

Import a source into a personal knowledge base and query it for evidence-backed answers.

REASON 3

Let a coding agent like Claude Code or Codex start and manage the local workspace for you.

What's in the stack?

PythonuvNode.js

How it stacks up

romarayt/raytsystem-public-osingar30/reviewersgloria/research-paper-pipeline
Stars808080
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperresearcherresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs Python 3.12-3.14 and the uv package manager, runs entirely on localhost with external features disabled by default.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notices, it also includes a patent grant.

Wtf does this do

raytsystem is a local-first workspace that gives one person or a small team a single place to manage documents, tasks, knowledge, and AI agent workflows, all running on their own machine instead of a cloud account. The interface only listens on the local loopback address, so nothing about it is reachable from outside the computer it runs on, and the project is explicit that it has not reached a stable, production ready release yet. The system provides a command center screen showing the health of the workspace, tasks, agent runs, and safety controls, a documents area for browsing, searching, and editing Markdown files with backlinks and history, and a knowledge universe view for exploring how evidence, tasks, agents, and code relate to each other. It also manages a durable task list with clear states and a permanent history, and lets a user inspect the available agents and skills, including their permissions, without those imported instructions being allowed to run on their own. Several core operations are built in: importing a new source into the knowledge base, querying that knowledge base for an evidence backed answer, checking the knowledge base's integrity, saving a conclusion as a reviewable draft, researching a topic, reviewing a completed run, and running a security review, plus a way to inspect video or other media under a defined policy. Real connections to outside AI providers, external network access, and other effects that reach beyond the local machine are turned off by default, and several integration features are still described as experimental rather than finished. To get started, a user needs macOS or Linux, or Windows through WSL2, along with Python 3.12 through 3.14 and the uv package manager, then clones the repository and runs a setup and start command from a terminal. Node.js is only needed if someone wants to rebuild the web interface themselves, since the built version is already included. The project can also be started by simply asking a supported AI coding agent, such as Claude Code or Codex, to start it in plain language, since those agents read the project's included instruction files. The project is released under the Apache 2.0 license.

Yoink these prompts

Prompt 1
Clone raytsystem, run uv sync and uv run raytsystem start, then open the local command center.
Prompt 2
Ask my coding agent to start raytsystem and import this file into the knowledge base.
Prompt 3
Run the raytsystem-lint skill to check my knowledge base's integrity.
Prompt 4
Explain what raytsystem disables by default before I enable any external provider execution.

Frequently asked questions

wtf is raytsystem-public-os?

A local-first, self-hosted workspace giving one person or a small team a command center for documents, tasks, and AI agent workflows.

What language is raytsystem-public-os written in?

Mainly Python. The stack also includes Python, uv, Node.js.

What license does raytsystem-public-os use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notices, it also includes a patent grant.

How hard is raytsystem-public-os to set up?

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

Who is raytsystem-public-os for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.