English · 한국어

Open Agent OS

Your agent. Your machine. Your rules.

The self-hosted agent OS that starts with a single URL — and grows with you from one mini PC to a company of 50 people. Built on Hermes Agent. Open source (Apache 2.0) for Personal & Project, source-available for Company.

Get started in one URL — install Hermes Agent and hand it this repository
Or read the source and bootstrap skills on GitHub

Self-hosted · No per-seat pricing · Telegram, Mattermost, Slack, Outline, Notion, Google Workspace, Microsoft 365 connected — not replaced.

WHY OPEN AGENT OS?

Yours, not rented.

Your agent lives on your hardware — a mini PC at home, a VPS for your team, your company's server. Conversations, files, and knowledge stay there. No per-seat cloud pricing, no data leaving your premises, no service you cannot walk away from.

One URL is the whole setup.

The bootstrap is a conversation. The agent reads the repository, explains your options, runs the installation, verifies every step with real checks, and hands you a working system. You never paste a command you do not understand.

Enterprise capability at indie cost.

The Personal edition runs on an N100-class mini PC with a low-cost flat LLM plan (≈ $10/month). The tools you already use get connected, not replaced. No new subscriptions.

A second brain that compounds.

Every conversation, document, and decision can be filed into your own wiki, and the agent maintains the cross-references and consistency. Unlike a stateless chatbot, your context accumulates into an asset — and the asset stays yours.

Start small, never re-platform.

Personal → Project → Company on one core. Begin with yourself; add teammates, shared knowledge, and governance when you are ready. Same skills, same files, same agent — just more of them.

Safe by design, governed at scale.

Destructive actions need your approval. Secrets live in one protected place and are never echoed. At company scale you get policy, audit, and admin controls — from a platform that already runs in production.

THE ONE-URL EXPERIENCE

Hand your agent one URL and answer a few one-tap gates. That is the entire installation.


You    set up openit-ai/open-agent-os

Agent  Sure — three editions: Personal (one person), Project (small team),
       Company (5–50 people). This machine fits Personal. Proceed?

You    yes

Agent  Installing…  OK Hermes   OK gateway   OK Telegram connected
       Two quick gates: paste your bot token, paste your user ID.
       OK LLM plan connected   OK wiki seeded   OK scheduled jobs on
       OK reboot survival verified on Ubuntu

Agent  Done — verified end-to-end. Try: "brief me every morning at 8."
       Full recipe list: docs/cookbook.md

Setup is a conversation, not a manual.

EDITIONS

Three editions, one core

Personal — for one person

A mini PC (N100-class, 16 GB), Telegram chat, and a second brain you own.

≈ $10/month LLM plan. No server required.

Project — for a small team (2–6)

One VPS (4 vCPU / 16 GB / 200 GB), a team assistant in Mattermost, Outline knowledge base, a dedicated bot mailbox. Personal → Project migration scripts included.

Company — for a company (5–50)

Everything in Project plus a governance layer: policy, just-in-time approvals, audit ledger, secret vault, admin console, optional Slack / Notion / Workspace / 365 integration, multi-LLM routing.

	Personal	Project	Company
For	one person	a small team (2–6)	a company (5–50)
Runs on	mini PC (N100-class, 16 GB)	one VPS (4 vCPU / 16 GB / 200 GB)	Project + governance layer
Install	Linux / macOS / Windows 11 (Git Bash)	signed packages + pinned Outline under systemd	inherits Project host services
Chat	Telegram	Mattermost + Telegram	+ Slack (optional)
Knowledge	git wiki + Obsidian	Outline + git wiki	+ Notion (optional), permission-aware index
Mail	personal	dedicated bot mailbox	existing suite integration
Models	one low-cost flat plan	low-cost flat plan	multi-LLM routing (premium optional)
Governance	minimal	team accounts	policy, approvals, audit, vault, admin console
New cost	≈ $10/month LLM plan	+ server	+ governance infrastructure

Google Workspace, Microsoft 365, Slack, and Notion are services a company already uses and pays for. Open Agent OS connects to them — they are not an added cost of this solution. The only new costs are the solution itself: server and LLM flat plan.

WHAT YOU CAN DO WITH IT

Personal — morning briefings, inbox triage, filing knowledge into your wiki, scheduled reminders, research summaries. All from your phone, in Telegram.

Project — a team assistant in Mattermost, meeting notes that become wiki pages, weekly reports, shared document search, a dedicated bot mailbox.

Company — a governed personal agent for every member, permission-aware company knowledge search, policy and audit across the fleet, optional Slack / Notion / Workspace / 365 integration.

COMPUTER USE

Computer use — the agent's hands

The agent doesn't just answer — it can operate the browser and applications on the machine where it runs.

Hangul (HWP) documents — drafts form-based HWPX documents such as grant applications, proposals, bids, and official letters; you do the final polish in your own office suite.
Work portals — automates login and repeated entry on accounting, tax, and ERP sites. Public certificates stay in your local vault; signing and submission run only after approval.
Government paperwork — from application through payment, issuance, saving, and a wiki record. Payment steps pause for your approval.

Risky actions — payments, sending, deletions — always pass through your approval first. Credential typing stays vault-only by default.

QUICK START

Quick start — "One URL"

Install Hermes Agent — official installer.
Tell it this repository — e.g. "set up openit-ai/open-agent-os".
Follow the agent — README → START-HERE → installs the oaos-bootstrap skill.
Pick an edition — Personal / Project / Company.
Pass the gates (3–6) — click links, choose options, paste keys or tokens; each is verified on the spot.
Verify and report — services, responses, files, wiki, and schedules checked end-to-end.

The agent does the reading, the file edits, and the commands. You only handle the gates.

SKILLS

Skills — how it grows

Core skills ship with Open Agent OS as plain SKILL.md packages, installable with Hermes. Add MCP servers and skills, and the agent gains capabilities without changing the core.

oaos-bootstrap — the bootstrap orchestrator: environment check → edition selection → setup → gates → verify → report.
oaos-ops — day-2 operations: health checks, backups, updates, restores, log inspection.

Optional extension skills (bring your own API keys):

promo-video-generation — 20-second promo videos for a place: chat interview → live-action images → shot script → generation. Quote-and-approve before every run.
higgsfield-media-generation — image and video generation helper with cost estimates built in.
figma-design-generation — design inside Figma from chat: screens, components, diagrams, design-to-code handoffs.
naver-cafe-manager — keyword monitoring with alerts, draft-first post writing, comment review and replies.
naver-blog-manager — new-post watching, draft-first writing, a collection pipeline that saves articles as markdown with original-resolution images.
sketchup-design-generation — exact-dimension 3D models from chat with SKP / PNG / STL exports.
vps-youtube-content — fetch YouTube transcripts on a VPS with a cheapest-first recovery ladder.

HARNESS & CONFIGURATION

Your agent's identity is plain markdown

The agent's identity and memory are markdown files on your machine — you can read, edit, and version them.

SOUL.md — the persona and working principles you define.
USER.md — your profile; the agent maintains it automatically from your conversations.
MEMORY.md — the agent's own notes; written by the agent, correctable by you.
AGENTS.md — per-project instructions for team and company workspaces.

Settings, secrets, skills, and schedules complete the surface — with templates and a seeding guide so your agent starts with a sane, personal harness instead of a blank one.

ARCHITECTURE

Architecture at a glance


Company   5–50 people / multi-LLM, governance, optional integrations
   ↑
Project   small team / Mattermost, Outline, bot mailbox
   ↑
Personal  one person / Telegram, second brain
   ↑
Common core   skills, knowledge, policy concepts, secret rules
   ↑
Runtime layer  Hermes Agent + adapters for each surface

Start with Personal. Grow to Project. Govern at Company scale. One core, no re-platforming.

ROADMAP & LICENSE

Roadmap

P0 — Bootstrap MVP (Personal) — README / START-HERE, oaos-bootstrap skill, personal install, verify. Done when a clean machine goes from one URL to ≤5 gates with all checks passing.
P1 — Project — project install/verify and Personal → Project migration scripts.
P2 — Company — absorb the enterprise platform, optional integrations, multi-LLM routing, governance.

License

Personal & Project — Apache License 2.0. Open source: free to use, modify, and distribute, including commercial use.
Company — Business Source License 1.1. Source-available: evaluation, development, and testing granted; production or commercial use requires a commercial license. Converts to Apache 2.0 on the Change Date (2030-08-27).

FOOTER CTA

Start with one URL

Install Hermes Agent, hand it this repository, and pick your edition. An hour later you have a running, verified agent that belongs to you.

GitHub — github.com/openit-ai/open-agent-os
Documentation — architecture, cookbook, FAQ, harness guide
Editions — Personal · Project · Company