Skip to main content
This guide is for developers who want to run Figranium’s source code directly on their machine for modification or testing, without using Docker.

​
Prerequisites

  • Node.js: Version 18 (LTS) or higher.
  • pnpm: Recommended package manager.
  • Playwright: Dependencies must be installed on your OS.

​
Setup Steps

1

Clone the Repository

2

Install Dependencies

3

Install Playwright Browsers

4

Environment Setup

Create a .env file in the root directory (refer to the Configuration page for available variables). At minimum, set:
5

Start the Application

You need to run both the backend server and the frontend development server simultaneously:Backend:
Frontend:
The frontend will be available at http://localhost:5173, and it will proxy API requests to the backend at http://localhost:11345.
6

(Optional) Start the Apple Silicon CAPTCHA companion

The solve_captcha action and task-level auto-solve setting work out of the box: remote solving is used if CAPTCHA_SOLVER_URL is configured, otherwise the built-in local model runs in-process (weights are cached in data/captcha-model/ on first use).On Apple Silicon, you can optionally run the native companion in a third terminal to offload inference to CoreML/MLX:
See CAPTCHA Solving for the full setup and environment variables.

​
Building for Production

To create a production build:
This generates a dist/ folder with optimized assets. You can then run the server in production mode: