Quickstart
Install Praxis, start a local world, and run your first simulation tick.
Requirements
Praxis is local-first. Use the self-contained macOS app, or run the Next.js application from source. External APIs and AI are optional: the default transports run entirely inside the simulation engine.
| Field | Meaning |
|---|---|
| macOS app | Universal build for Apple silicon and Intel Macs |
| Node.js + pnpm | Required only when running from source |
| Claude CLI | Optional; used only when AI generation is enabled |
| Mapbox token | Optional; the control panel has a map fallback without it |
Run locally
Choose the Mac app or source
Download the current Mac app, or install the repository workspace.
Terminal git clone https://github.com/jameshbarber/artificial-praxis.git cd artificial-praxis pnpm installStart Praxis
Open the installed app, or start the development server:
Terminal pnpm devOpen localhost:3000. The first request creates a seeded world and persists it under
.praxis/.Advance the world
Use the play control in the panel, click a manual step, or call the tick route directly.
Terminal curl -X POST http://localhost:3000/api/simulation/tick \ -H 'Content-Type: application/json' \ -d '{"steps":1}'
Take a first look
A useful first run is about watching cause and effect. Keep the initial mixed-reality scenario, advance a few ticks, and inspect the same actor across the map, messages, decisions, appointments, tasks, operations, and events.
An actor moves or creates a message.
Praxis chooses the next concrete action.
The configured transport books, sends, or cancels.
Success or failure updates the person and operational queues.
Next steps
- Read How Praxis works to understand the world and substrate.
- Use Scenarios and controls to shape a repeatable run.
- Follow Configure an HTTP connector when you are ready to exercise a real API.