Skill for initial ActonOS project setup, environment verification, and dependency installation.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Use this skill when setting up the ActonOS development environment from scratch or verifying an existing setup.
Before starting development, verify the following tools are installed:
| Tool | Min Version | Verification Command | Install Guide |
|---|---|---|---|
| Go | 1.26+ | go version | https://go.dev/dl/ |
| Node.js | 22 LTS+ | node --version | https://nodejs.org/ |
| npm | 10+ | npm --version | Bundled with Node.js |
| Make | 4.0+ | make --version | apt install make or choco install make |
| Git | 2.40+ | git --version | https://git-scm.com/ |
| Tool | Purpose | Installation |
|---|---|---|
| Docker 24+ | Container builds | https://docs.docker.com/get-docker/ |
| golangci-lint | Go linting | go install github.com/golangci-lint/golangci-lint/cmd/golangci-lint@latest |
| air | Go live-reload | go install github.com/air-verse/air@latest |
git clone https://github.com/actonos/actonos.git
cd actonos
make deps
This runs:
go mod download && go mod verify — downloads Go modulescd web && npm ci — installs Node packages# Create local data directory for development
mkdir -p dev-data/{config,agents,tokens,storage,logs,overrides,plugins,skills,mcp-servers,workspace}
Create .env in the project root (not committed):
RUNTIME_MODE=docker
LOG_LEVEL=debug
LISTEN_ADDR=:8080
DATA_DIR=./dev-data
DISABLE_TAILSCALE=true
DISABLE_SANDBOX=true
# Check Go modules
go mod verify
# Check frontend dependencies
cd web && npm ls --depth=0
# Try a build
make build-only
# Run tests
make test-unit
make dev
This starts:
http://localhost:8080http://localhost:5173| Issue | Solution |
|---|---|
CGO_ENABLED error | Ensure using modernc.org/sqlite, not mattn/go-sqlite3 |
| Node version mismatch | Use nvm install 22 and nvm use 22 |
| Port conflict | Set LISTEN_ADDR=:8081 in .env |
| Permission denied on scripts | Run chmod +x scripts/*.sh |
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Skill for developing AI agent engine components in internal/agent/. Covers the ReAct loop, swarm delegation, planning, verification, memory reflection, and cron automation.
The English summary is being prepared. Showing the original description.
Skill for developing REST API endpoints in internal/server/. Covers routing, request validation, WebSocket streaming, and API conventions.
The English summary is being prepared. Showing the original description.
Skill for building ActonOS: Web UI → Go binary → Docker image → ISO. Covers the entire build pipeline.
The English summary is being prepared. Showing the original description.
Skill for developing messaging channel adapters via WASM Plugins and managing routing, session state, pairing codes, and accounts in internal/channels/.
The English summary is being prepared. Showing the original description.
Skill for developing the ActonOS React 19 + Tailwind v4 frontend adhering to the official DESIGN.md specification. Covers design tokens, component decomposition, zero-hardcoded-text i18n, and go:embed delivery.
The English summary is being prepared. Showing the original description.
Skill for creating ActonOS releases. Covers version bumping, changelog management, git tagging, Docker image publishing, and ISO creation.
The English summary is being prepared. Showing the original description.