AgentOS - Universal Agent Runtime

PyPI version License: MIT Python 3.10+

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.yaml manifest
  • 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 .zip skill packages with skill.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.

  1. Fork the repo
  2. Create a feature branch: git checkout -b feat/amazing-skill
  3. Write your skill with a skill.yaml manifest
  4. Upload to the marketplace or submit a PR
  5. 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

Star History Chart

Built with ❤️ by the AgentOS community. Let's make the Agent OS ecosystem thrive.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.50.22)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Nexus.wu-yi_123 from gravatar.com Nexus.wu-yi_123

Credits

Author: AgentOS Team

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

all api cli dev distributed evaluation hitl-ui rag server

Tags

agent ai framework function-calling llm middleware multi-agent production rag swarm

Classifiers

Report project as malware

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.50.10.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nexus_agentos-1.50.10-py3-none-any.whl (1.2 MB view details)

Uploaded Python 3

File details

Details for the file nexus_agentos-1.50.10.tar.gz.

File metadata

  • Download URL: nexus_agentos-1.50.10.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.6

File hashes

Hashes for nexus_agentos-1.50.10.tar.gz
Algorithm Hash digest
SHA256 953da01475c645fa651dcf07450cac6526808709bbde9b5e69d725663ec82f6f
MD5 d8833dcdfee9e5d462a05166fac7c5a9
BLAKE2b-256 c7bc7e32375b9991b504ee3abdd733c50acd8e1aec65ae700234042d18bf7bd8

See more details on using hashes here.

File details

Details for the file nexus_agentos-1.50.10-py3-none-any.whl.

File metadata

File hashes

Hashes for nexus_agentos-1.50.10-py3-none-any.whl
Algorithm Hash digest
SHA256 6088942140110836538536bd7aca86b14253df7bb6d7565b7d944c485b68094d
MD5 ee050a4622a481a78e7b5b9057830541
BLAKE2b-256 c46914ec7f0dd1e9631388bdbb256ca05fd62326d0dcaf9b7f27df13d4bca18c

See more details on using hashes here.

Release history Release notifications | RSS feed

1.50.22

1.50.21

1.50.20

1.50.19

1.50.18

1.50.17

1.50.16

1.50.15

1.50.14

1.50.13

1.50.12

1.50.11

This release

1.50.10

1.50.9

1.50.8

1.50.7

1.50.6

1.50.5

1.50.3

1.50.2

1.50.0

1.49.2

1.49.1

1.49.0

1.48.0

1.47.0

1.46.0

1.45.0

1.44.0

1.43.0

1.42.0

1.41.0

1.40.0

1.39.0

1.38.0

1.37.0

1.36.0

1.35.0

1.34.0

1.33.0

1.32.0

1.31.0

1.30.0

1.29.0

1.28.0

1.27.0

1.26.0

1.25.0

1.24.0

1.23.0

1.22.0

1.21.0

1.20.0

1.16.47

1.16.43

1.16.42

1.16.41

1.16.40

1.16.39

1.16.38

1.16.37

1.16.36

1.16.35

1.16.34

1.16.33

1.16.32

1.16.31

1.16.30

1.16.29

1.16.28

1.16.27

1.16.26

1.16.25

1.16.24

1.16.23

1.16.22

1.16.21

1.16.20

1.16.19

1.16.18

1.16.17

1.16.16

1.16.15

1.16.14

1.16.13

1.16.12

1.16.11

1.16.10

1.16.9

1.16.8

1.16.6

1.16.4

1.16.3

1.16.2

1.16.1

1.16.0

1.15.30

1.15.10

1.15.9

1.15.8

1.15.7

1.15.6

1.15.5

1.15.4

1.15.3

1.15.2

1.15.1

1.15.0

1.14.9

1.14.8

1.14.7

1.14.6

1.14.4

1.14.3

1.14.2

1.14.1

1.14.0

1.12.1

1.9.9

1.9.8

1.9.7

1.9.6

1.9.5

1.9.4

1.9.3

1.9.2

1.9.1

1.9.0

1.8.3

1.8.2

1.8.1

1.8.0

1.7.8

1.7.6

1.7.5

1.7.4

1.7.1

1.7.0

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.0

1.3.38

1.3.37

1.3.36

1.3.35

1.3.34

1.3.33

1.3.32

1.3.31

1.3.30

1.3.29

1.3.28

1.3.27

1.3.26

1.3.25

1.3.24

1.3.23

1.3.22

1.3.21

1.3.20

1.3.19

1.3.18

1.3.17

1.3.16

1.3.15

1.3.14

1.3.13

1.3.12

1.3.11

1.3.10

1.3.9

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.0

0.99.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page