{"id":35094039,"url":"https://github.com/nuwax-ai/nuwax","last_synced_at":"2026-04-15T05:01:34.201Z","repository":{"id":303849775,"uuid":"1016903129","full_name":"nuwax-ai/nuwax","owner":"nuwax-ai","description":"Nuwax Agent OS - The world's first universal agent operating system, building your private vertical general-purpose agent.  通用智能体操作系统，打造你私有的垂类通用智能体。新一代AI应用设计、开发、实践平台，无需代码，轻松创建，适合各类人群，支持多种端发布及API，提供完善的工作流、插件以及应用开发能力，RAG知识库与数据表存储能力，MCP接入以及开放能力。","archived":false,"fork":false,"pushed_at":"2026-04-14T08:52:31.000Z","size":98381,"stargazers_count":744,"open_issues_count":10,"forks_count":135,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-04-14T10:28:15.934Z","etag":null,"topics":["a2a","agent","agent-os","agent-sandbox","agentic","agentic-rag","agentos","application","chatbot","mcp","rag","skills","workflow"],"latest_commit_sha":null,"homepage":"https://nuwax.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuwax-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-07-09T17:50:12.000Z","updated_at":"2026-04-13T20:10:43.000Z","dependencies_parsed_at":"2025-07-10T03:36:12.907Z","dependency_job_id":"3bedd854-f44a-4651-985c-cece18dfe439","html_url":"https://github.com/nuwax-ai/nuwax","commit_stats":null,"previous_names":["nuwax-ai/nuwax"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/nuwax-ai/nuwax","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuwax-ai%2Fnuwax","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuwax-ai%2Fnuwax/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuwax-ai%2Fnuwax/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuwax-ai%2Fnuwax/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuwax-ai","download_url":"https://codeload.github.com/nuwax-ai/nuwax/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuwax-ai%2Fnuwax/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31826902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a2a","agent","agent-os","agent-sandbox","agentic","agentic-rag","agentos","application","chatbot","mcp","rag","skills","workflow"],"created_at":"2025-12-27T15:04:24.310Z","updated_at":"2026-04-15T05:01:34.189Z","avatar_url":"https://github.com/nuwax-ai.png","language":"TypeScript","funding_links":[],"categories":["📚 Projects (1974 total)"],"sub_categories":["MCP Servers"],"readme":"# Nuwax\n\nNuwax AI - Easily build and deploy your private Agentic AI solutions.\n\nOfficial Website: [https://nuwax.com](https://nuwax.com)\n\nDemo: [https://agent.nuwax.com](https://agent.nuwax.com)\n\n[中文文档](README.zh-CN.md)|[English Doc](README.md) | [Contributing](CONTRIBUTING.md) | [Documentation](docs/)\n\n## Installation \u0026 Deployment\n\nUse the official nuwax-cli command tool to quickly deploy services locally.\n\n### Quick Start\n\n#### Environment Preparation\n\n##### System Requirements\n\n- **System Requirements**: Ubuntu 22.04 LTS or later (other Linux versions not fully tested), macOS 10.15+, Windows 10/11 (support coming soon)\n- **Hardware Requirements**: 4 cores 8GB RAM or higher\n- **Environment Requirements**: docker, docker-compose V2 environment [Docker Installation Guide](#docker-environment-installation)\n\n##### Supported Platforms\n\n- **Linux**: x86_64, ARM64\n  - Ubuntu 22.04 LTS (recommended)\n  - Current user needs Docker permissions, verify with `docker ps`. If you encounter permission issues, you can run with sudo privileges.\n  - Alibaba Cloud mirror acceleration is recommended\n- **macOS**: Intel, Apple Silicon (M1/M2), Universal\n  - macOS 10.15 (Catalina) and later versions\n  - OrbStack is recommended (free for personal use, better performance)\n  - Ensure OrbStack or Docker Desktop is started\n  - First-time use may require allowing unknown developers: System Preferences → Security \u0026 Privacy\n\n#### Local Deployment Service Guide\n\nThere are 2 deployment services:\n\n- Main project service (required)\n- Agent Computer (Sandbox) deployment guide (optional)\n\nIn the main local service, configure one or more Agent Computer deployment addresses to use the Agent Computer (Sandbox). Since the \"Agent Computer (Sandbox)\" includes a personal computer (sandbox) which requires more resources, it supports separate deployment across multiple servers.\n\n#### Deploy Main Service\n\n[Installation Documentation](https://nuwax.com/deploy.html)\n\n#### Agent Computer (Sandbox) Deployment Guide\n\nYou can deploy Agent Computer services on multiple different servers, achieving distributed agent sandbox capabilities through configuration.\n\n\u003e **Environment Requirements**: Each server needs Docker and Docker Compose environment installed, refer to [Docker Installation Documentation](https://nuwax.com/deploy.html#%E6%8E%A8%E8%8D%90%E6%96%B9%E6%A1%88-%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE-docker-%E8%84%9A%E6%9C%AC).\n\n[Installation Documentation](https://nuwax.com/agent-computer-deploy.html)\n\n### Common Management Commands\n\n#### Service Management\n\n- Start service: `./nuwax-cli docker-service start`\n- Stop service: `./nuwax-cli docker-service stop`\n- Restart service: `./nuwax-cli docker-service restart`\n- Check status: `./nuwax-cli docker-service status`\n\n#### Backup Management\n\n\u003e Backup service requires stopping Docker application servers, it's recommended to operate during business low-peak periods\n\n- **One-click Backup (Recommended):**\n  - Manual backup execution: `./nuwax-cli auto-backup run`\n  - List all backups: `./nuwax-cli list-backups`\n  - Restore from backup: `./nuwax-cli rollback [BACKUP_ID]`\n\n#### Upgrade Management\n\n**Application service upgrade, using command `./nuwax-cli auto-upgrade-deploy run` will automatically detect and download new versions for deployment.**\n\nComplete upgrade process:\n\n```bash\n# Check if deployment client has new version and update\n./nuwax-cli check-update install\n# Update application service\n./nuwax-cli auto-upgrade-deploy run\n```\n\n### Docker Environment Installation\n\n\u003e **Important Note**: Docker and Docker Compose are core dependencies for running this service and must be installed correctly.\n\nIf your system doesn't have Docker environment installed yet, please refer to the detailed **[Docker Environment Installation Guide](docs/en/docker-install.md)**.\n\nThis installation guide includes detailed installation steps for the following platforms:\n\n- **Ubuntu 24.04.3 LTS** (recommended Linux distribution)\n- **macOS** (supports OrbStack and Docker Desktop)\n- **Mirror acceleration configuration** (for mainland China users)\n\n### Recommended: One-Click Docker Installation Script\n\n\u003e Community one-click Docker installation script\n\nThis script supports 13 Linux distributions, including domestic operating systems (openEuler, Anolis OS, OpenCloudOS, Alinux, Kylin Linux), one-click installation of docker, docker-compose with automatic configuration of Xuanyuan mirror acceleration.\n\n```shell\nbash \u003c(wget -qO- https://xuanyuan.cloud/docker.sh)\n```\n\n#### Script Features and Advantages\n\n✅ Supports 13 mainstream distributions: openEuler, OpenCloudOS, Anolis OS, Alinux (Alibaba Cloud), Kylin Linux, Fedora, Rocky Linux, AlmaLinux, Ubuntu, Debian, CentOS, RHEL, Oracle Linux\n\n✅ Complete support for domestic operating systems: Deep adaptation for domestic OS (openEuler, Anolis OS, OpenCloudOS, Alinux, Kylin Linux), supports automatic version detection and optimal configuration\n\n✅ Intelligent multi-mirror source switching: Built-in 6+ domestic mirror sources including Alibaba Cloud, Tencent Cloud, Huawei Cloud, USTC, Tsinghua, etc., automatically detects and selects the fastest source\n\n✅ Special handling for older systems: Supports expired systems like Ubuntu 16.04, Debian 9/10, automatically configures compatible installation solutions\n\n✅ Dual installation guarantee: Automatically switches to binary installation if package manager installation fails, ensuring installation success rate\n\n✅ macOS/Windows friendly prompts: Automatically detects macOS and Windows systems, provides appropriate Docker Desktop installation guidance\n\n**Quick Docker Installation Verification:**\n\n```bash\n# Check Docker version\ndocker --version\n\n# Check Docker Compose version\ndocker compose version\n\n# Run test container\ndocker run hello-world\n```\n\nIf the above commands all run successfully, your Docker environment is ready and you can proceed with Nuwax service deployment.\n\n## Architecture Diagram\n\n```\n┌────────────────────────────────────────────────────────────────────────────┐\n│                           Frontend Layer                                   │\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────────────────┐  │\n│  │  PC Web  │  │   H5     │  │ Mini App │  │  IM (Feishu/DingTalk/  │  │\n│  │          │  │          │  │          │  │   WeCom/Slack)         │  │\n│  └──────────┘  └──────────┘  └──────────┘  └─────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                        Access Layer                                        │\n│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────────┐   │\n│  │  REST API    │  │  Long        │  │       WebSocket             │   │\n│  │              │  │ Connection   │  │                             │   │\n│  └──────────────┘  └──────────────┘  └──────────────────────────────┘   │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                      Application Layer                                     │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              Component Library                                       │  │\n│  │  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │  │\n│  │  │ Model│ │Know- │ │ Data │ │Plugin│ │ Work-│ │  MCP │ │ Skill│ │  │\n│  │  │      │ │ ledge│ │ Table│ │      │ │ flow │ │      │ │      │ │  │\n│  │  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              Management Portal                                        │  │\n│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │  │\n│  │  │  User    │ │  Audit   │ │  Public  │ │ Content  │ │   Task   │ │  │\n│  │  │Management│ │Management│ │  Model   │ │Management│ │Management│ │  │\n│  │  ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ │  │\n│  │  │   Log    │ │   Menu   │ │ System   │ │          │ │          │ │  │\n│  │  │  Query   │ │Permission│ │  Config  │ │          │ │          │ │  │\n│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              Product Applications                                    │  │\n│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐  │  │\n│  │  │   Web App    │  │   Q\u0026A        │  │    General Agent         │  │  │\n│  │  │              │  │   Agent      │  │                          │  │  │\n│  │  └──────────────┘  └──────────────┘  └──────────────────────────┘  │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                    Infrastructure Layer                                    │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │                    Lower-level Components                            │  │\n│  │                                                                       │  │\n│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────────┐ │  │\n│  │  │   Cloud     │  │  nuwaclaw   │  │   General Agent Engine     │ │  │\n│  │  │   Sandbox   │  │   PC Client │  │                            │ │  │\n│  │  │             │  │ (mac/win/   │  │  ┌───────────────────────┐ │  │\n│  │  │             │  │  docker)    │  │  │  MCP Integration      │ │  │\n│  │  │             │  │             │  │  ├───────────────────────┤ │  │\n│  │  │             │  │             │  │  │  File Management     │ │  │\n│  │  │             │  │             │  │  │  Skill Management     │ │  │\n│  │  │             │  │             │  │  │  ACP Adapter Layer    │ │  │\n│  │  │             │  │             │  │  │  ┌─────────────────┐ │ │  │\n│  │  │             │  │             │  │  │  │ Supported Agent:│ │ │  │\n│  │  │             │  │             │  │  │  │ claudecode      │ │ │  │\n│  │  │             │  │             │  │  │  │ opencode        │ │ │  │\n│  │  │             │  │             │  │  │  │ codex           │ │ │  │\n│  │  │             │  │             │  │  │  │ openclaw        │ │ │  │\n│  │  │             │  │             │  │  │  │ kimicli         │ │ │  │\n│  │  │             │  │             │  │  │  └─────────────────┘ │ │  │\n│  │  │             │  │             │  │  ├───────────────────────┤ │  │\n│  │  │             │  │             │  │  │  Browser             │ │  │\n│  │  │             │  │             │  │  │  Automation          │ │  │\n│  │  │             │  │             │  │  │  GUI Automation      │ │  │\n│  │  │             │  │             │  │  │  Network Channel     │ │  │\n│  │  │             │  │             │  │  │  Runtime Integration │ │  │\n│  │  │             │  │             │  │  └───────────────────────┘ │  │\n│  │  │             │  │             │  └─────────────────────────────┘ │  │\n│  │  └─────────────┘  └─────────────┘                                   │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │                    Core Infrastructure                                │  │\n│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────┐  │  │\n│  │  │ Database │ │  Cache   │ │  Vector  │ │  Search  │ │ Model │  │  │\n│  │  │  MySQL   │ │  Redis   │ │  Milvus  │ │ Elastic  │ │ Proxy│  │  │\n│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────┘  │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n### Project Repository Overview\n\nThe Nuwax AI Agent Platform consists of multiple interconnected repositories:\n\n#### **Frontend \u0026 Mobile**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **nuwax** | Frontend Web | [https://github.com/nuwax-ai/nuwax](https://github.com/nuwax-ai/nuwax) |\n| **nuwax-mobile** | Mobile Application | [https://github.com/nuwax-ai/nuwax-mobile](https://github.com/nuwax-ai/nuwax-mobile) |\n| **noVNC** | Web-based VNC Client | [https://github.com/nuwax-ai/noVNC](https://github.com/nuwax-ai/noVNC) |\n\n#### **Backend \u0026 Application Layer**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **nuwax-backend** | Application Layer (Backend) | [https://github.com/nuwax-ai/nuwax-backend](https://github.com/nuwax-ai/nuwax-backend) |\n\n#### **Agent Engine \u0026 Clients**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **nuwaclaw** | Agent PC Client (mac/win/docker) | [https://github.com/nuwax-ai/nuwaclaw](https://github.com/nuwax-ai/nuwaclaw) |\n| **nuwaxcode** | Nuwa Agent Engine (based on open-source opencode) | [https://github.com/nuwax-ai/nuwaxcode](https://github.com/nuwax-ai/nuwaxcode) |\n| **claude-code-acp-ts** | Claude Code ACP based on Zed | [https://github.com/nuwax-ai/claude-code-acp-ts](https://github.com/nuwax-ai/claude-code-acp-ts) |\n\n#### **Infrastructure \u0026 Services**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **rcoder** | Sandbox \u0026 Container Scheduling (includes General Agent Engine) | [https://github.com/nuwax-ai/rcoder](https://github.com/nuwax-ai/rcoder) |\n| **mcp-proxy** | MCP Service (used by sandbox) | [https://github.com/nuwax-ai/mcp-proxy](https://github.com/nuwax-ai/mcp-proxy) |\n| **nuwax-file-server** | File Service (used by sandbox and nuwaclaw, includes skill sync) | [https://github.com/nuwax-ai/nuwax-file-server](https://github.com/nuwax-ai/nuwax-file-server) |\n\n#### **Web Application Development**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **xagi-frontend-templates** | Web Application Development Templates | [https://github.com/nuwax-ai/xagi-frontend-templates](https://github.com/nuwax-ai/xagi-frontend-templates) |\n| **vite-plugin-design-mode** | Visual Editor Vite Plugin | [https://github.com/nuwax-ai/vite-plugin-design-mode](https://github.com/nuwax-ai/vite-plugin-design-mode) |\n| **dev-inject** | Web Application Smart Script Injection | [https://github.com/nuwax-ai/dev-inject](https://github.com/nuwax-ai/dev-inject) |\n\n#### **Plugin \u0026 Script Execution**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **run_code_rmcp** | Plugin Script Execution (TypeScript/JavaScript/Python) | [https://github.com/nuwax-ai/run_code_rmcp](https://github.com/nuwax-ai/run_code_rmcp) |\n\n#### **Network \u0026 Utilities**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **lanproxy-go-client** | Network Tunnel Client (used by nuwaclaw) | [https://github.com/ffay/lanproxy-go-client](https://github.com/ffay/lanproxy-go-client) |\n\n### Agent Platform Frontend\n\n[中文文档](docs/ch/front-project.md) |[English Doc](docs/en/front-project.md)\n\n##### Contributing Guide\n\n1. Fork the project\n2. Create feature branch\n3. Submit code changes\n4. Create Pull Request\n\n## Community \u0026 Support\n\nJoin the Nuwax AI Agent Platform community for technical support and latest updates!\n\n### Official Links\n\n- **Website**: https://nuwax.com\n- **Demo**: https://agent.nuwax.com\n\n### Community Channels\n\n| Channel | Description |\n|---------|-------------|\n| **GitHub Issues** | [Submit issues](https://github.com/nuwax-ai/nuwax/issues) |\n| **WeChat Group** | Add assistant `nuwax-ai` |\n| **QQ Group** | Group ID: `1041169423` |\n| **WeChat Official Account** | Follow \"女娲智能体\" for feedback |\n| **Douyin/Video Account** | Follow for latest video content |\n\n\u003e 📱 For **WeChat Group, Official Account, and Douyin QR codes**, please visit [User Manual](https://nuwax.com/user-manual.html)\n\n## License\n\nApache 2.0 License - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuwax-ai%2Fnuwax","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuwax-ai%2Fnuwax","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuwax-ai%2Fnuwax/lists"}