### Build and run from source (Option B) Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Clone the repository, install dependencies, build, and start the server with a custom home directory, workspace, and port. Requires Node.js and npm. After setup, open http://localhost:3000. ```bash git clone https://github.com/hhyqhh/inno-agent.git cd inno-agent npm install # pulls the Pi SDK from npm npm run build # compiles backend + web mkdir -p runtime/config runtime/data runtime/skills workspace cp config.example.json runtime/config/config.json # Edit runtime/config/config.json and set providers[*].apiKey npm run server -- --home ./runtime --workspace ./workspace --port 3000 ``` -------------------------------- ### First-run setup commands Source: https://github.com/hhyqhh/inno-agent/blob/main/CLAUDE.md Creates runtime directories and copies the example config. Requires editing runtime/config/config.json to set providers[*].apiKey. ```bash mkdir -p runtime/config runtime/data runtime/skills workspace cp config.example.json runtime/config/config.json # Edit runtime/config/config.json — set providers[*].apiKey ``` -------------------------------- ### Full config.json structure example Source: https://github.com/hhyqhh/inno-agent/blob/main/CLAUDE.md Shows the complete structure of the user-facing config.json file, including defaultProvider, defaultModel, providers, server, channels, bridge, subagents, plugins, contentHub, memory, and ocrApi sections. The providers map is abbreviated with a comment. This example is based on config.example.json at the repo root. ```json { "defaultProvider": "innospark", "defaultModel": "claude-sonnet-4-6", "providers": { /* ... */ }, "server": { "port": 3000 }, "channels": { "feishu": { "enabled": false, "personalOnly": true, "allowedUserIds": [] }, "wechat": { "enabled": false, "mode": "bridge", "allowedUserIds": [], "sidecarBaseUrl": "http://127.0.0.1:4319" } }, "bridge": { "token": "replace-me-with-a-secret" }, "subagents": { "enabled": false }, "plugins": { "todo": { "enabled": true }, "permissionSystem": { "enabled": true }, "webAccess": { "enabled": true }, "codemode": { "enabled": false } }, "contentHub": { "type": "github", "owner": "Chloris-Blaxk", "repo": "inno-agent-hub", "ref": "main", "skillsPath": "skill-library", "presetsPath": "workspace-templates", "baseUrl": "", "token": "" }, "memory": { "l1Enabled": true, "l2Enabled": true, "l3Enabled": true }, "ocrApi": { "token": "", "model": "PaddleOCR-VL-1.6", "baseUrl": "https://paddleocr.aistudio-app.com/api/v2/ocr/jobs" } } ``` -------------------------------- ### Run with Docker (Option C) Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Starts the service with Docker Compose, serving on port 3000 and mounting the runtime and workspace directories. ```bash docker compose up -d # serves on :3000, mounts runtime/ and workspace/ ``` -------------------------------- ### Enable computer use for local server/CLI with INNO_DESKTOP Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Starts the server with computer use enabled by setting INNO_DESKTOP=1. To disable, restart without the environment variable. ```bash INNO_DESKTOP=1 npm run server -- --home ./runtime --workspace ./workspace --port 3000 ``` -------------------------------- ### config.json example configuration Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Shows the structure of the runtime/config/config.json file with default provider, model, providers, server, channels, memory, and UI settings. The server hot-rewrites this file when switching models in the UI. ```json { "defaultProvider": "innospark", "defaultModel": "claude-sonnet-4-6", "providers": { "innospark": { "baseUrl": "https://api.example.com", "api": "anthropic-messages", "apiKey": "replace-me", "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }] } }, "server": { "port": 3000 }, "channels": { "feishu": { "enabled": false }, "wechat": { "enabled": false, "mode": "ilink" } }, "memory": { "l1Enabled": true, "l2Enabled": true, "l3Enabled": true }, "ui": { "theme": "light", "closeBehavior": "ask" } } ``` -------------------------------- ### restart-dev.sh usage commands Source: https://github.com/hhyqhh/inno-agent/blob/main/CLAUDE.md Orchestrates the full dev lifecycle: build, start, status, logs, smoke tests, stop, and help. Supports flags like --skip-build, --mode, --sandbox, --port, --web-port, --tail. ```bash bash restart-dev.sh # build + dev mode start both frontend and backend bash restart-dev.sh --skip-build # skip compilation, restart processes only bash restart-dev.sh build # build only, no service startup bash restart-dev.sh start # start services without building bash restart-dev.sh status # show process health and port status bash restart-dev.sh logs server # tail backend logs bash restart-dev.sh logs web # tail frontend logs bash restart-dev.sh smoke # run health/session/WS smoke tests bash restart-dev.sh stop # stop all managed processes bash restart-dev.sh --help # list all options ``` -------------------------------- ### Run modes and dev server Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Lists the available npm scripts for running the web UI, CLI, desktop app, sandboxed web UI, and the development setup with Vite HMR. The dev command runs both backend and web dev servers concurrently. ```bash npm run server # Web UI (API + built frontend on :3000) npm run start # CLI (terminal agent, no HTTP) npm run electron # Desktop app locally npm run server:sandbox # Web UI with OS-level sandbox (requires ripgrep) # Dev: backend on :3000 + Vite HMR on :5173 npm run dev:server & npm run web:dev ``` -------------------------------- ### Common npm commands for build, server, CLI, sandbox, dev, and watch Source: https://github.com/hhyqhh/inno-agent/blob/main/CLAUDE.md Run from repo root. Uses npm --workspace. Includes build, server, CLI, sandbox, dev, watch, and direct TypeScript execution. ```bash # Build backend + web npm run build # Build frontend only npm --workspace inno-agent-web run build # Start HTTP server (serves API + web/dist on port 3000) npm run server -- --home ./runtime --workspace ./workspace --port 3000 # Start CLI (terminal agent, no HTTP) npm run start -- --home ./runtime --workspace ./workspace # Sandbox mode (pi-sandbox enabled, isolates agent tool execution) npm run sandbox -- --home ./runtime --workspace ./workspace npm run server:sandbox -- --home ./runtime --workspace ./workspace --port 3000 # Dev: run server and Vite dev separately npm run dev:server # backend on :3000 npm run web:dev # Vite on :5173, proxies /api -> :3000 # Watch mode (TypeScript recompile on change) npm run dev # `tsc --watch` in apps/inno-agent (backend only, does not rebuild frontend) # Run a TypeScript file directly without building npx tsx some-script.ts # restart-dev.sh orchestration npm run restart # full build + dev restart npm run restart:fast # skip build, restart only ``` -------------------------------- ### Electron desktop build commands Source: https://github.com/hhyqhh/inno-agent/blob/main/CLAUDE.md Run the desktop app locally or package for macOS (DMG) and Windows (NSIS + MSI). ```bash npm run electron # Run desktop app locally npm run electron:build # Package macOS DMG (arm64) npm run electron:build:win # Package Windows NSIS + MSI (x64) ``` -------------------------------- ### Export and view showcase session Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Exports a recorded session from the CLI and then builds, serves, and opens the replay site. The export command requires a substring to match a session. ```bash npm run showcase:export -- --session # pick one recorded session npm run showcase:view # build + serve + open the replay site ``` -------------------------------- ### Production deployment command Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Runs the Inno Agent server with environment variables for configuration, data, skills, workspace, and port. Use this in a production layout that separates code, config, data, and workspace. ```bash INNO_CONFIG_DIR=/etc/inno-agent \ INNO_DATA_DIR=/var/lib/inno-agent/data \ INNO_SKILLS_DIR=/var/lib/inno-agent/skills \ INNO_WORKSPACE_DIR=/srv/inno-workspace \ INNO_PORT=3000 \ npm run server ``` -------------------------------- ### Repository layout tree Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Shows the top-level directory structure of the Inno Agent repository, identifying the role of each folder. ```text apps/inno-agent/ Backend (CLI + HTTP server), TypeScript → dist/ apps/inno-agent/web/ Frontend (React 19 + Tailwind 4 + Vite) apps/inno-agent/presets/ Bundled preset workspaces (offline fallback) apps/showcase/ Session replay showcase site (real product UI + recorded cases) electron/ Electron main process (desktop app) scripts/content-hub-server/ Self-hosted Content Hub bundle service runtime/ Local runtime state (config, data, skills) — gitignored workspace/ Default agent working directory — gitignored ``` -------------------------------- ### Invoke pptx_to_svg.py CLI Source: https://github.com/hhyqhh/inno-agent/blob/main/apps/inno-agent/scripts/README.md Command to convert a PowerPoint file to SVG, embedding images and using flat inheritance mode. Output is written to the specified directory. ```bash python3 pptx_to_svg.py --embed-images --inheritance-mode flat -o ``` -------------------------------- ### Explicit computer use override in config.json Source: https://github.com/hhyqhh/inno-agent/blob/main/README.md Overrides the INNO_DESKTOP environment default in both directions. Set enabled to true or false to force the feature on or off. ```json "plugins": { "computerUse": { "enabled": true } } ``` -------------------------------- ### Run mobile layout smoke test with environment variables Source: https://github.com/hhyqhh/inno-agent/blob/main/docs/mobile-layout-review-2026-09-14.md Executes the mobile layout smoke test script with required environment variables for Playwright module path, Chromium path, test URL, output directory, and optional session title. The session title is optional; without it 128 states are tested, with it 135. The script asserts document width, menu bounds, mobile toolbar geometry, drawer/workspace placement, settings bounds, title separation, and conversation button overlap. Screenshots and JSON results are written outside the repository by default. ```shell PLAYWRIGHT_MODULE=/absolute/path/to/playwright \ CHROMIUM_PATH=/absolute/path/to/chromium \ MOBILE_TEST_URL=http://localhost:5173 \ MOBILE_TEST_OUTPUT=/tmp/inno-mobile-smoke \ MOBILE_TEST_SESSION_TITLE='an existing conversation title' \ node scripts/mobile-layout-smoke.cjs ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.