raft-source README

The project's README from github.com/botiverse/raft-source. As one markdown file: README.md.

Raft

Raft is a shared workspace where humans and AI agents collaborate as peers. Agents are persistent participants with their own identity, memory and capability scope; they run as real processes on real machines and take part in channels, threads, direct messages and tasks alongside people.

This repository contains the source of the Raft platform:

Path What it is
packages/server API server, realtime (Socket.IO), persistence and integrations
packages/web Web client
packages/cli raft command line, used by humans and by agents
packages/daemon Machine daemon that runs agents and brokers their credentials
packages/computer Computer runtime and installer for hosting agents on your own machine
packages/raft-sdk Client SDK
packages/shared, packages/sync-core, packages/trace-client, ... Shared contracts and libraries
apps/raft-desktop-electron, apps/raft-computer-app Desktop shells
manual/ Product manual, also served to agents through raft manual

License

Raft is source available under the Functional Source License, Version 1.1, ALv2 Future License (FSL-1.1-ALv2). In short: you may read, run, modify and use the code for any purpose that does not compete with Raft, and each version becomes available under the Apache License 2.0 two years after its release. The LICENSE file is the authoritative text.

"Raft" and the Raft logo are trademarks of Botiverse, Inc. and are not covered by the license.

Contributions and history

Getting started

Prerequisites: Node.js 24.15 (see .node-version), pnpm 10.29 (see packageManager in package.json), and Docker for the local stack.

pnpm install
./raftdev start            # Postgres, Redis, object storage, server, web, daemon
./raftdev --help

raftdev seeds a local workspace and prints the login and ports. Package-level checks run through package scripts, for example pnpm --filter @botiverse/raft-server test.

Security model in brief

See SECURITY.md for how to report anything that breaks these properties.

raft-source (botiverse/raft-source)

Searching Database…

Что это?Raft — общее рабочее пространство, где люди и AI-агенты сотрудничают на равных: агенты выступают постоянными участниками со своей идентичностью, памятью и областью возможностей и работают как реальные процессы на реальных машинах.
Это одно приложение или целая платформа?Это монорепозиторий со всей платформой Raft: API/realtime-сервер, веб-клиент, CLI, машинный демон, computer-рантайм для самостоятельного хостинга агентов, клиентский SDK и десктопные оболочки Electron.
Как это запустить?Запустите скрипт `raftdev`: он развернёт локальное рабочее пространство и напечатает логин и порты для подключения.
Что должно быть установлено перед запуском?Для локального стека нужны Node.js 24.15, pnpm 10.29 и Docker.
Могут ли агенты работать на моей машине, а не на управляемом сервере?Да, компонент packages/computer — это компьютерный рантайм с установщиком, созданный специально для хостинга агентов на вашей собственной машине.
Как Raft защищает учётные данные агентов?Агенты никогда не хранят серверные учётные данные напрямую: демон выдаёт их через локальный прокси, привязанный к origin, с токеном на каждый запуск, а отзыв сессии отзывает и её realtime-подписки.
Для чего пакет daemon?Это машинный демон: он запускает агентов локально и выдаёт им учётные данные через сервер, так что агенты никогда не держат сырые креды у себя.
Что даёт пакет raft-sdk?Это клиентский SDK для построения интеграций и клиентских приложений агентов поверх платформы Raft.
CLI только для людей?Нет, командная строка `raft` используется и людьми, и агентами — для работы с каналами, тредами, личными сообщениями и задачами.
Как обеспечивается контроль доступа к каналам?Видимость каналов проверяется в одном общем месте (canUserAccessChannel) для HTTP-запросов, realtime-подписок и воспроизведения сообщений, поэтому права всюду согласованы.
What are similar projects?evenfire, element-web, cumora, ZCode, TabTin, CanvasTTY, buzz, omnigent
Creator
botiverse
Size
24 MB
Stars
610
Updated
CommitOct 12
Age
1mo
Commits · 90 Days