Nuwax

Nuwax AI - Easily build and deploy your private Agentic AI solutions.

Official Website: https://nuwax.com

Demo: https://agent.nuwax.com

中文文档|English Doc | Contributing | Documentation

Installation & Deployment

Use the official nuwax-cli command tool to quickly deploy services locally.

Quick Start

Environment Preparation

System Requirements

System Requirements: Ubuntu 22.04 LTS or later (other Linux versions not fully tested), macOS 10.15+, Windows 10/11 (support coming soon)
Hardware Requirements: 4 cores 8GB RAM or higher
Environment Requirements: docker, docker-compose V2 environment Docker Installation Guide

Supported Platforms

Linux: x86_64, ARM64
- Ubuntu 22.04 LTS (recommended)
- Current user needs Docker permissions, verify with docker ps. If you encounter permission issues, you can run with sudo privileges.
- Alibaba Cloud mirror acceleration is recommended
macOS: Intel, Apple Silicon (M1/M2), Universal
- macOS 10.15 (Catalina) and later versions
- OrbStack is recommended (free for personal use, better performance)
- Ensure OrbStack or Docker Desktop is started
- First-time use may require allowing unknown developers: System Preferences → Security & Privacy

Local Deployment Service Guide

There are 2 deployment services:

Main project service (required)
Agent Computer (Sandbox) deployment guide (optional)

In 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.

Deploy Main Service

Installation Documentation

Agent Computer (Sandbox) Deployment Guide

You can deploy Agent Computer services on multiple different servers, achieving distributed agent sandbox capabilities through configuration.

Environment Requirements: Each server needs Docker and Docker Compose environment installed, refer to Docker Installation Documentation.

Installation Documentation

Common Management Commands

Service Management

Start service: ./nuwax-cli docker-service start
Stop service: ./nuwax-cli docker-service stop
Restart service: ./nuwax-cli docker-service restart
Check status: ./nuwax-cli docker-service status

Backup Management

Backup service requires stopping Docker application servers, it's recommended to operate during business low-peak periods

One-click Backup (Recommended):
- Manual backup execution: ./nuwax-cli auto-backup run
- List all backups: ./nuwax-cli list-backups
- Restore from backup: ./nuwax-cli rollback [BACKUP_ID]

Upgrade Management

Application service upgrade, using command ./nuwax-cli auto-upgrade-deploy run will automatically detect and download new versions for deployment.

Complete upgrade process:

# Check if deployment client has new version and update
./nuwax-cli check-update install
# Update application service
./nuwax-cli auto-upgrade-deploy run

Docker Environment Installation

Important Note: Docker and Docker Compose are core dependencies for running this service and must be installed correctly.

If your system doesn't have Docker environment installed yet, please refer to the detailed Docker Environment Installation Guide.

This installation guide includes detailed installation steps for the following platforms:

Ubuntu 24.04.3 LTS (recommended Linux distribution)
macOS (supports OrbStack and Docker Desktop)
Mirror acceleration configuration (for mainland China users)

Recommended: One-Click Docker Installation Script

Community one-click Docker installation script

This 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.

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

Script Features and Advantages

✅ Supports 13 mainstream distributions: openEuler, OpenCloudOS, Anolis OS, Alinux (Alibaba Cloud), Kylin Linux, Fedora, Rocky Linux, AlmaLinux, Ubuntu, Debian, CentOS, RHEL, Oracle Linux

✅ 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

✅ 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

✅ Special handling for older systems: Supports expired systems like Ubuntu 16.04, Debian 9/10, automatically configures compatible installation solutions

✅ Dual installation guarantee: Automatically switches to binary installation if package manager installation fails, ensuring installation success rate

✅ macOS/Windows friendly prompts: Automatically detects macOS and Windows systems, provides appropriate Docker Desktop installation guidance

Quick Docker Installation Verification:

# Check Docker version
docker --version

# Check Docker Compose version
docker compose version

# Run test container
docker run hello-world

If the above commands all run successfully, your Docker environment is ready and you can proceed with Nuwax service deployment.

Architecture Diagram

┌────────────────────────────────────────────────────────────────────────────┐
│                           Frontend Layer                                   │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────────────────┐  │
│  │  PC Web  │  │   H5     │  │ Mini App │  │  IM (Feishu/DingTalk/  │  │
│  │          │  │          │  │          │  │   WeCom/Slack)         │  │
│  └──────────┘  └──────────┘  └──────────┘  └─────────────────────────┘  │
└────────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌────────────────────────────────────────────────────────────────────────────┐
│                        Access Layer                                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────────┐   │
│  │  REST API    │  │  Long        │  │       WebSocket             │   │
│  │              │  │ Connection   │  │                             │   │
│  └──────────────┘  └──────────────┘  └──────────────────────────────┘   │
└────────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌────────────────────────────────────────────────────────────────────────────┐
│                      Application Layer                                     │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐  │
│  │              Component Library                                       │  │
│  │  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │  │
│  │  │ Model│ │Know- │ │ Data │ │Plugin│ │ Work-│ │  MCP │ │ Skill│ │  │
│  │  │      │ │ ledge│ │ Table│ │      │ │ flow │ │      │ │      │ │  │
│  │  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │  │
│  └─────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐  │
│  │              Management Portal                                        │  │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │  │
│  │  │  User    │ │  Audit   │ │  Public  │ │ Content  │ │   Task   │ │  │
│  │  │Management│ │Management│ │  Model   │ │Management│ │Management│ │  │
│  │  ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ │  │
│  │  │   Log    │ │   Menu   │ │ System   │ │          │ │          │ │  │
│  │  │  Query   │ │Permission│ │  Config  │ │          │ │          │ │  │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │  │
│  └─────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐  │
│  │              Product Applications                                    │  │
│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐  │  │
│  │  │   Web App    │  │   Q&A        │  │    General Agent         │  │  │
│  │  │              │  │   Agent      │  │                          │  │  │
│  │  └──────────────┘  └──────────────┘  └──────────────────────────┘  │  │
│  └─────────────────────────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌────────────────────────────────────────────────────────────────────────────┐
│                    Infrastructure Layer                                    │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐  │
│  │                    Lower-level Components                            │  │
│  │                                                                       │  │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────────┐ │  │
│  │  │   Cloud     │  │  nuwaclaw   │  │   General Agent Engine     │ │  │
│  │  │   Sandbox   │  │   PC Client │  │                            │ │  │
│  │  │             │  │ (mac/win/   │  │  ┌───────────────────────┐ │  │
│  │  │             │  │  docker)    │  │  │  MCP Integration      │ │  │
│  │  │             │  │             │  │  ├───────────────────────┤ │  │
│  │  │             │  │             │  │  │  File Management     │ │  │
│  │  │             │  │             │  │  │  Skill Management     │ │  │
│  │  │             │  │             │  │  │  ACP Adapter Layer    │ │  │
│  │  │             │  │             │  │  │  ┌─────────────────┐ │ │  │
│  │  │             │  │             │  │  │  │ Supported Agent:│ │ │  │
│  │  │             │  │             │  │  │  │ claudecode      │ │ │  │
│  │  │             │  │             │  │  │  │ opencode        │ │ │  │
│  │  │             │  │             │  │  │  │ codex           │ │ │  │
│  │  │             │  │             │  │  │  │ openclaw        │ │ │  │
│  │  │             │  │             │  │  │  │ kimicli         │ │ │  │
│  │  │             │  │             │  │  │  └─────────────────┘ │ │  │
│  │  │             │  │             │  │  ├───────────────────────┤ │  │
│  │  │             │  │             │  │  │  Browser             │ │  │
│  │  │             │  │             │  │  │  Automation          │ │  │
│  │  │             │  │             │  │  │  GUI Automation      │ │  │
│  │  │             │  │             │  │  │  Network Channel     │ │  │
│  │  │             │  │             │  │  │  Runtime Integration │ │  │
│  │  │             │  │             │  │  └───────────────────────┘ │  │
│  │  │             │  │             │  └─────────────────────────────┘ │  │
│  │  └─────────────┘  └─────────────┘                                   │  │
│  └─────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐  │
│  │                    Core Infrastructure                                │  │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────┐  │  │
│  │  │ Database │ │  Cache   │ │  Vector  │ │  Search  │ │ Model │  │  │
│  │  │  MySQL   │ │  Redis   │ │  Milvus  │ │ Elastic  │ │ Proxy│  │  │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────┘  │  │
│  └─────────────────────────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────────────────────────┘

Project Repository Overview

The Nuwax AI Agent Platform consists of multiple interconnected repositories:

Frontend & Mobile

Repository	Description	URL
nuwax	Frontend Web	https://github.com/nuwax-ai/nuwax
nuwax-mobile	Mobile Application	https://github.com/nuwax-ai/nuwax-mobile
noVNC	Web-based VNC Client	https://github.com/nuwax-ai/noVNC

Backend & Application Layer

Repository	Description	URL
nuwax-backend	Application Layer (Backend)	https://github.com/nuwax-ai/nuwax-backend

Agent Engine & Clients

Repository	Description	URL
nuwaclaw	Agent PC Client (mac/win/docker)	https://github.com/nuwax-ai/nuwaclaw
nuwaxcode	Nuwa Agent Engine (based on open-source opencode)	https://github.com/nuwax-ai/nuwaxcode
claude-code-acp-ts	Claude Code ACP based on Zed	https://github.com/nuwax-ai/claude-code-acp-ts

Infrastructure & Services

Repository	Description	URL
rcoder	Sandbox & Container Scheduling (includes General Agent Engine)	https://github.com/nuwax-ai/rcoder
mcp-proxy	MCP Service (used by sandbox)	https://github.com/nuwax-ai/mcp-proxy
nuwax-file-server	File Service (used by sandbox and nuwaclaw, includes skill sync)	https://github.com/nuwax-ai/nuwax-file-server

Web Application Development

Repository	Description	URL
xagi-frontend-templates	Web Application Development Templates	https://github.com/nuwax-ai/xagi-frontend-templates
vite-plugin-design-mode	Visual Editor Vite Plugin	https://github.com/nuwax-ai/vite-plugin-design-mode
dev-inject	Web Application Smart Script Injection	https://github.com/nuwax-ai/dev-inject

Plugin & Script Execution

Repository	Description	URL
run_code_rmcp	Plugin Script Execution (TypeScript/JavaScript/Python)	https://github.com/nuwax-ai/run_code_rmcp

Network & Utilities

Repository	Description	URL
lanproxy-go-client	Network Tunnel Client (used by nuwaclaw)	https://github.com/ffay/lanproxy-go-client

Agent Platform Frontend

中文文档 |English Doc

Contributing Guide

Fork the project
Create feature branch
Submit code changes
Create Pull Request

Community & Support

Join the Nuwax AI Agent Platform community for technical support and latest updates!

Official Links

Website: https://nuwax.com
Demo: https://agent.nuwax.com

Community Channels

Channel	Description
GitHub Issues	Submit issues
WeChat Group	Add assistant `nuwax-ai`
QQ Group	Group ID: `1041169423`
WeChat Official Account	Follow "女娲智能体" for feedback
Douyin/Video Account	Follow for latest video content

📱 For WeChat Group, Official Account, and Douyin QR codes, please visit User Manual

License

Apache 2.0 License - see LICENSE for details.

Version	Changes	Urgency	Date
v1.1.4	## ✨ 新功能 - 国际化 (i18n) 全面演进： - 实现后端驱动的 i18n 运行时治理，完成核心页面与组件的国际化迁移。 - 覆盖 AppDev 聊天、AntV X6 工作流（节点、画布、运行结果）、系统管理（角色、用户组、日志）等多个核心模块。 - 新增本地默认字典，优化多语言切换的鲁棒性。 - API 密钥管理增强： - 新增 API 密钥（API KEY）管理页面，支持密钥的创建、编辑、删除及动态分页加载。 - 新增 API 调用日志页面与控制台，支持调用频率统计与权限配置（ApiKeyPermission）。 - 智能体与会话体验优化： - 新增开放授权应用（OpenApp）相关页面，支持应用详情查看与历史会话记录追踪。 - 新增会话详情组件（ConversationDetails），优化历史会话列表展示逻辑。 - 增强 `ChatInputHome` 的 @ 提及功能，新增 `AtMentionIcon` 并优化弹窗定位逻辑。 - 智能体模型设置（AgentModelSettin	High	4/15/2026
v1.1.3	## 🐛 Bug 修复 - 修复当工作空间是第一个菜单时，因为退出登录未清除空间信息，导致更换账号再次进入页面后，空间ID不正确； - 修复广场查询智能体时未携带智能体子类型（ChatBot），导致查询结果包含了网页应用型智能体；	High	4/2/2026

nuwax

Description

README