AgentOS - Universal Agent Runtime
AgentOS is an open-source universal agent runtime designed for the multi-agent era. It provides a unified execution environment where AI agents can discover, install, and compose skills from a decentralized marketplace, while connecting to any MCP-compatible tool server.
pip install nexus-agentos
Why AgentOS?
| Problem | AgentOS Solution |
|---|---|
| Agents siloed in different frameworks | Universal runtime — one env runs OpenClaw, LangChain, custom agents |
| No marketplace for agent skills | Built-in Skill Market — devs upload, users install, admins review |
| MCP servers fragmented | 8 built-in MCP servers, 34 tools out of the box |
| No TUI for agent management | Terminal UI (Textual) — file browser, skill manager, task runner |
| Hard to compose multi-agent workflows | Sub-agent dispatch — agents delegate to specialists automatically |
Quick Start
1. Install
pip install nexus-agentos
# Or from source
git clone https://github.com/wuyifeishu/nexus-agentos.git
cd nexus-agentos && pip install -e .
2. Launch the Skill Marketplace
python -m agentos.server.marketplace_platform
Open http://localhost:8899/static/platform.html — you'll see the full marketplace with:
- Browse: search/discover 64 built-in skills across 11 categories
- Login/Register: JWT auth for developers
- Upload: zip your skill with a
skill.yamlmanifest - Review: admin panel for security scanning, approve/reject
3. Run the Terminal UI
python -m agentos.desktop
Ctrl+M opens the Market Panel. Ctrl+F opens File Browser. Full keyboard-driven.
Architecture
┌─────────────────────────────────────────────────────────┐
│ AgentOS Runtime │
│ ┌─────────┐ ┌──────────┐ ┌───────────────────────┐ │
│ │ TUI │ │ Agent │ │ Sub‑Agent Dispatcher │ │
│ │(Textual)│ │ Engine │ │ (search/browser/file) │ │
│ └─────────┘ └──────────┘ └───────────────────────┘ │
│ ┌─────────┐ ┌──────────┐ ┌───────────────────────┐ │
│ │ Skill │ │ MCP │ │ Marketplace Server │ │
│ │Registry │ │ Registry │ │ (FastAPI + SQLite) │ │
│ └─────────┘ └──────────┘ └───────────────────────┘ │
│ 64 Skills │ 8 Servers │ Upload/Review/Download │
└─────────────────────────────────────────────────────────┘
Built-in MCP Servers
| Server | Tools | Description |
|---|---|---|
filesystem |
7 | read_file, write_file, list_directory, search_files, get_file_info, create_directory, move_file |
webfetch |
3 | fetch_url, fetch_json, check_url |
memory |
6 | store_memory, retrieve_memory, search_memory, list_categories, delete_memory, update_memory |
search |
4 | web_search, news_search, image_search, suggest |
git |
4 | git_status, git_log, git_diff, git_branch |
shell |
3 | run_command, system_info, disk_usage |
code |
3 | run_python, run_shell, lint_code |
text |
4 | count_tokens, extract_regex, summarize_text, format_json |
All MCP servers are zero-dependency, pure Python implementations. No external processes required.
Skill Categories (64 built-in)
| Category | Count | Examples |
|---|---|---|
| Development | 14 | github, docker, git, kubernetes, terraform, postgres, redis |
| Productivity | 8 | google-workspace, microsoft-365, calendar, email, todoist |
| Communication | 7 | slack, discord, notion, jira, teams, webex, zendesk |
| Data | 8 | sql-query, csv-tools, bigquery, snowflake, mongodb, elasticsearch |
| Document | 5 | docx, xlsx, pptx, pdf, markdown |
| Media | 5 | image-edit, video-process, audio-transcribe, screen-capture, svg-create |
| System | 4 | system-info, file-watch, cron-scheduler, network-tools |
| Security | 4 | secret-manager, threat-scanner, 1password, auth-proxy |
| AI | 5 | prompt-optimizer, token-counter, embedding-service, langchain-tools, rag-pipeline |
| Uncategorized | 4 | weather, translation, currency-converter, timezone |
Skill Marketplace Platform
A production-ready marketplace for the AgentOS ecosystem:
For Developers
- Register/login with email & password (bcrypt + JWT)
- Upload
.zipskill packages withskill.yaml/manifest.json - Automatic security scanning on upload: dangerous imports, shell injection, obfuscation, hardcoded keys, excessive permissions
- Track downloads and reviews
- Developer profile pages
For Users
- Browse/search skills by name, category, tags
- One-click install from any ecosystem source
- Rate and review installed skills
For Admins
- Review queue with security findings per skill
- Approve/reject with comments
- Skill quality and safety enforcement
API Endpoints
POST /api/auth/register - Create developer account
POST /api/auth/login - Login, receive JWT
GET /api/skills - Browse/search published skills
GET /api/skills/{id} - Skill detail
GET /api/skills/{id}/download - Download skill zip
POST /api/skills/upload - Upload new skill (auth required)
GET /api/my/skills - My uploaded skills
GET /api/developers/{username} - Developer profile
POST /api/admin/review/{id} - Approve/reject (admin)
GET /api/admin/review-queue - Pending reviews (admin)
GET /api/categories - Category listing
Security Scanning
Every uploaded skill is automatically scanned for:
| Check | Severity | Description |
|---|---|---|
| Dangerous imports | Critical | os.system, subprocess, socket, ctypes |
| Shell injection | Critical | os.system(), eval(), exec(), __import__() |
| Code obfuscation | High | Base64-encoded payloads, eval chains |
| Hardcoded secrets | High | API keys, tokens, passwords in source |
| File permission escalation | Medium | chmod 777, os.chown |
| Network exfiltration | High | Suspicious requests.post to unknown hosts |
Roadmap
- Universal Agent Runtime
- 64 Built-in Skills
- 8 MCP Servers (34 tools)
- Skill Marketplace with web UI
- Developer registration & upload
- Security scanning pipeline
- Admin review queue
- Terminal UI (TUI)
- Multi-agent orchestration dashboard
- Skill dependency resolution
- Federated marketplace discovery
- Blockchain-based skill provenance
Contributing
We welcome contributions! The Skill Marketplace is our highest-priority area.
- Fork the repo
- Create a feature branch:
git checkout -b feat/amazing-skill - Write your skill with a
skill.yamlmanifest - Upload to the marketplace or submit a PR
- If you want to contribute to the platform itself, check the issues labeled
good first issue
Skill Manifest Format
name: my-awesome-skill
version: 0.1.0
description: Does something awesome
author:
name: Your Name
url: https://github.com/yourname
category: dev
tags: [python, automation]
entrypoint: main.py
requires:
python: ">=3.10"
packages: [requests, httpx]
license: MIT
License
MIT License. See LICENSE for details.
Star History
Built with ❤️ by the AgentOS community. Let's make the Agent OS ecosystem thrive.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nexus_agentos-1.29.0.tar.gz
(4.1 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nexus_agentos-1.29.0.tar.gz.
File metadata
- Download URL: nexus_agentos-1.29.0.tar.gz
- Upload date:
- Size: 4.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af938120aeb94e8ec7e9494e45704c5de07c37cd78b41ae8bac407123c914edb
|
|
| MD5 |
805b48b0d0f1c22de125188e3965e82e
|
|
| BLAKE2b-256 |
a51fc8af5b57d4e0023f8fe2ba970e2462c55ebb0b0df9f031b79aa4e73c325a
|
File details
Details for the file nexus_agentos-1.29.0-py3-none-any.whl.
File metadata
- Download URL: nexus_agentos-1.29.0-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
44e514011365be45ce34a6a2637ccfd4c0811a40fd80e0ee6e81b32b940d74be
|
|
| MD5 |
47e3633e9fbae7c727ae9c4f59fcf082
|
|
| BLAKE2b-256 |
da04a366c1bd5a3d84f06f958499bd647cc16e624d520fa3fccf0646930aef68
|
