Artemis Documentation

Artemis lets you build mobile apps and websites by describing them in natural language. It uses AI to generate code, sets up a live preview, and deploys to your phone — all from a chat interface.

Installation

Install Artemis on your machine with a single command:

Prerequisites

• Node.js 18+ — nodejs.org
• Git — for collaboration and version control
• An AI API key — Anthropic (Claude) or OpenAI

What the installer does

1. Checks your system for prerequisites
2. Installs OpenClaw (the AI gateway) if not present
3. Sets up the Artemis backend (app scaffolding, server management)
4. Configures a gateway with a secure token
5. Optionally sets up a Cloudflare tunnel for remote access
6. Prints connection details for the Artemis mobile app

Manual Setup

If you prefer to set things up manually:

# Install OpenClaw
npm install -g openclaw

# Configure your AI provider
openclaw config set anthropic.apiKey sk-ant-...

# Start the gateway
openclaw gateway start

# Clone the Artemis backend tools
git clone https://github.com/openclaw/artemis-backend ~/artemis-apps
cd ~/artemis-apps && npm install

Quick Start

1. Install the Artemis app on your phone (iOS App Store / Android coming soon)
2. Open the app and sign in
3. Choose "Personal Hosted" and enter your gateway URL and token
4. Tap "New App" and describe what you want to build
5. Watch the AI build your app in real-time
6. Open the preview link on your phone

Project Files

Artemis uses .artemis.json files to define project configuration. Place this file at the root of any project to make it importable into Artemis.

Schema

{
  "name": "My App",
  "slug": "my-app",
  "type": "expo | website | node",
  "version": "1.0.0",
  "description": "A brief description",

  "deployment": {
    "platform": "artemis-cloud | self-hosted",
    "url": "https://...",
    "env": { "API_KEY": "..." }
  },

  "git": {
    "remote": "https://github.com/user/repo",
    "branch": "main",
    "autoSync": true
  },

  "dependencies": {
    "cli": ["expo-cli"],
    "system": ["node>=18", "git"]
  },

  "codebase": {
    "entry": "App.js",
    "srcDir": "src/",
    "buildCmd": "npm run build",
    "startCmd": "npm start",
    "testCmd": "npm test"
  },

  "artemis": {
    "model": "claude-sonnet-4-20250514",
    "agentInstructions": "Custom AI instructions...",
    "context": ["README.md", "ARCHITECTURE.md"]
  }
}

Fields

Self-Hosting Guide

Running Artemis on your own machine gives you full control over your data and infrastructure.

Requirements

• CPU: 2+ cores recommended
• RAM: 4GB minimum (each app uses ~200-400MB)
• Disk: 10GB+ for app storage
• Network: Stable internet for AI API calls and tunneling

Remote Access

To access your Artemis instance from your phone when away from home, set up a tunnel:

# Using Cloudflare Tunnel (recommended)
cloudflared tunnel --url http://localhost:18789

# The tunnel URL is your gateway URL in the app

Collaboration via Git

Self-hosted instances use Git for collaboration. When you share an app, collaborators clone the repo and run it on their own Artemis instance.

Collaboration

Share your apps with others by inviting collaborators. They can view, modify, and run your apps on their own devices.

Cloud-Hosted

Use the built-in invite system — share a link and collaborators get instant access.

Self-Hosted

Push your app to a Git repo and share the repository URL. Collaborators import it via the project import feature.

Architecture

Artemis is a multi-layer system connecting your phone to an AI-powered development environment.

Data Flow

1. You describe an app in the Artemis mobile app
2. The message travels via WebSocket through a tunnel to the OpenClaw gateway
3. The gateway routes it to an AI agent (Claude or GPT)
4. The agent scaffolds the app, writes code, and starts a dev server
5. A tunnel URL is returned for live preview on your phone

Components

Manager API

The Artemis Manager runs on port 3100 and provides a REST API for app lifecycle management.

Endpoints

Configuration

Artemis uses OpenClaw for its gateway configuration. Key settings:

{
  "gateway": {
    "port": 18789,
    "token": "your-secure-token"
  },
  "anthropic": {
    "apiKey": "sk-ant-..."
  },
  "tools": {
    "exec": {
      "timeoutSec": 120
    }
  }
}

FAQ

Troubleshooting