freshcrate
Home > AI Agents > AgentOS

AgentOS

Manage your tokens, eliminate wasted usage! Not a LangChain/OpenClaw wrapper. A fully self-developed agent team orchestration system with proprietary architecture & memory system, delivering 5x+ effic

Description

Manage your tokens, eliminate wasted usage! Not a LangChain/OpenClaw wrapper. A fully self-developed agent team orchestration system with proprietary architecture & memory system, delivering 5x+ efficiency and 5x less token consumption than OpenClaw for engineering-grade tasks.

README

Agent OS

The seminal fourth "Operating System Philosophy" in human computing history.

English | 简体中文

AtomGit star GitHubVersion License Build

C/C++ Python Go Rust TypeScript

🌟 Introduction

AgentOS is an intelligent agent operating system that provides comprehensive OS-level support for orchestrating agent teams.

💡 Innovation Highlights

Foundational Theory 👉 Multibody Cybernetic Intelligent System

  • Pure Kernel: Only atomic mechanisms (IPC/Mem/Task/Time), ensuring purity and efficiency.
  • Cognitive Loop: Perception → Planning → Action, with dual-system synergy (System 1 + System 2).
  • Memory Stratification: L1 Raw → L2 Features → L3 Structures → L4 Patterns, enabling intelligence emergence.
  • Inherent Security: Four-layer protection: Sandbox Isolation, Permission Arbitration, Input Sanitization, Audit Trail.
  • Token Efficiency: Saves approximately 500% tokens compared to traditional frameworks.
  • Comprehensive SDKs: Native support for Go / Python / Rust / TypeScript.

🎯 Core Philosophy

Team Orchestration

  • Precisely coordinates multi‑agent collaboration
  • Enables efficient task orchestration and resource scheduling

Autonomous Evolution

  • Self‑evolving capability
  • Dynamically adjusts strategies
  • Continuously optimizes execution effectiveness

✨ Groundbreaking Architecture · Inherent Security · Intelligence Emergence ✨

🏗️ System Architecture

Architecture Design
Complete architecture from kernel to application:

Application Layer (openlab)
    ⇅
Service Layer (daemon)
    ⇅
Kernel Layer (atoms)
    ⇅
Security Layer (cupolas)
    ⇅
Support Layer (commons)
    ⇅
SDK Layer (toolkit)

Design Principles
Built upon ARCHITECTURAL_PRINCIPLES:

  • System Perspective: Feedback loops · Layered decomposition · Holistic design · Emergence management → Response <10ms
  • Kernel Perspective: Minimalist kernel · Contractual interfaces · Service isolation · Pluggable strategies → Kernel ~25K LOC
  • Cognitive Perspective: Dual‑system synergy · Incremental evolution · Memory stratification · Forgetting mechanism → Token savings 500%
  • Engineering Perspective: Security built‑in · Observability · Resource determinism · Cross‑platform consistency → Test coverage >90%
  • Design Aesthetics: Simplicity first · Extreme attention to detail · Human‑centric · Perfectionism → API <50 per module

🚀 Quick Start

📦 Requirements

  • OS: Ubuntu 22.04+ / macOS 13+ / Windows 11 (WSL2)
  • Compiler: GCC 11+ / Clang 14+ (C11/C++17)
  • Build Tools: CMake 3.20+, Ninja
  • Python: 3.10+ (Required for OpenLab)

🔨 Installation & Build

# 1. Clone repository
git clone https://atomgit.com/spharx/agentos.git && cd agentos

# 2. Install dependencies (Ubuntu)
sudo apt install -y build-essential cmake gcc g++ libssl-dev libsqlite3-dev ninja-build

# 3. Build kernel
mkdir build && cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=ON
cmake --build . --parallel $(nproc)

# 4. Run tests
ctest --output-on-failure

🐳 Docker Quick Start

# Build image
docker build -f scripts/deploy/docker/Dockerfile.kernel -t agentos:latest .

# Run container
docker run -d --name agentos -p 8080:8080 -v ./config:/app/config agentos:latest

💻 Usage

Language Usage
C/C++ Develop via syscalls.h system call interface
Python Install via pip install agentos then import directly
Go Use import "github.com/spharx/agentos/toolkit/go"
Rust Use use agentos_toolkit::prelude::*;
TypeScript Install via npm install @spharx/agentos-toolkit then import directly

📚 Documentation

Document Core Content
📘 Architectural Principles Multibody Cybernetic Intelligent System, 24 core principles
🚀 Quick Start 5‑minute getting‑started guide
⚙️ Build Guide Detailed build steps and options
🧪 Testing Guide Unit/Integration/Contract testing
🐳 Deployment Guide Docker/Kubernetes deployment

❔ FAQ

Q1: How does AgentOS differ from traditional AI Agent frameworks?

AgentOS is an operating‑system‑level product, not merely a framework:

Dimension AgentOS Traditional Frameworks
Positioning Multi‑agent collaboration OS Single agent
Architecture Microkernel + strict layering Loosely coupled modules
Security Four‑layer inherent security Application‑level protection
Memory Four‑layer stratification system Vector database
Token Efficiency Saves ~500% No optimization
Q2: What scenarios is it suitable for?

✅ Perfect for

  • 🎯 Complex multi‑step task orchestration
  • 🧠 Long‑term memory and knowledge accumulation
  • 🔒 High‑security enterprise applications
  • 💾 Resource‑constrained embedded scenarios (atomslite)
  • 🌐 Multi‑language development teams

❌ Not suitable for

  • 🚫 Simple single‑call tasks (overkill)
Q3: How is security guaranteed?

Security built‑in design, four‑layer protection

Protection Layer Implementation
Virtual Workspace Process/Container/WASM sandbox isolation
Permission Arbitration RBAC + YAML rule engine
Input Sanitization Regex filtering + Type checking
Audit Trail Full‑chain tamper‑proof logging

See cupolas security documentation

Q4: What prerequisites are needed?
Role Prerequisites Time to Get Started
Application Developer Python/Go basics 1‑2 days
System Developer C/C++, OS fundamentals 1‑2 weeks
Architect Microkernel, distributed systems 1 month

Recommended Path: Quick StartArchitectural PrinciplesCoreLoopThree

☀️ This is not humanity's sunset, but the dawn of a new world ☀️

🤝 Contributing

"Intelligence emergence, and nothing less, is the ultimate sublimation of AI."

This is the future we are stepping into.

🚩 The Power of Belief

Believe
The spirit of open source can unleash the collective wisdom of the community, propelling humanity to new heights.

Witness
Every day of our work is part of history, destined to be engraved on the monument of human civilization, witnessing the true emergence of intelligence.

This is not humanity's sunset, but the dawn of a new world.

💫 Ways to Contribute

Whether you are an experienced developer or just starting out:

  • 🐛 Find Issues → Report bugs, help us improve quality
  • 💡 Share Ideas → Suggest new features, make the project stronger
  • 📝 Share Knowledge → Improve documentation, help more people understand AgentOS
  • 🔧 Write Code → Submit PRs, jointly build a better intelligent agent OS

📝 Contribution Process

See Contributing Guide

Fork Project → Create Branch → Develop & Test → Submit PR → Code Review → Merge to Main

Main Platforms: AtomGit (Recommended) · Gitee · GitHub

🔥 "A faint light cannot illuminate the entire path, yet it guides our direction forward." 🔥

📜 License

This project is licensed under the Apache License 2.0. See LICENSE file for details.


"From data intelligence emerges."

AtomGit · Gitee · GitHub · Official Website

© 2026 SPHARX Ltd. All Rights Reserved.


⭐️ Github Star History

Star History Chart

Release History

VersionChangesUrgencyDate
main@2026-04-21Latest activity on main branchHigh4/21/2026
v1.0.0.9Latest release: v1.0.0.9High4/9/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

fronaFrona is a personal AI assistant. You create autonomous agents, give them tools, and talk to them through a chat interface. Agents act on their own. They browse the web, run code, develop applicationsmain@2026-04-20
eternegoThe Eternego codebasemaster@2026-04-18
CopilotKitThe Frontend Stack for Agents & Generative UI. React + Angular. Makers of the AG-UI Protocolv1.56.2
MMClawUltra-Lightweight, Pure Python Multimodal Agent.main@2026-04-14
seedance2-skill🎥 Generate precise video prompts for Jimeng Seedance 2.0 using structured patterns, templates, and AI agent compatibility.main@2026-04-21