fluvie_server

One self-hostable server for the full AI power of Fluvie: the render API, AI authoring, the MCP server, and a documentation helper, all in one binary. Enable the parts you want with environment variables; install one image, not three services.

Libraries

  • package:fluvie_server/client.dart — the web-safe render client (http only), for a Flutter app on web, mobile, or desktop.
  • package:fluvie_server/server.dart — the dart:io/shelf server.

Run it

dart run packages/fluvie_server/bin/fluvie_server.dart

The render API listens on HOST:PORT (default 0.0.0.0:8080). See the server guide and the AI and MCP guide for configuration, the MCP modes, and Docker images.

AI cost control

Pin a cheap model with FLUVIE_AI_MODEL. Bound per-IP spend with FLUVIE_AI_RATE_LIMIT (default 5), FLUVIE_AI_RATE_WINDOW (default 1m), and FLUVIE_AI_DAILY_QUOTA (default 50); over-limit requests get HTTP 429 with a Retry-After header. A render job now also includes code (the printed Dart Video build()) and spec (the authored VideoSpec JSON). The MCP server adds a spec_to_dart tool, and generate_video and edit_video return the printed code. See the AI and MCP guide for details.

Libraries

client
The web-safe client for the Fluvie render API.
fluvie_server
The Fluvie server: render API, AI authoring, MCP, and a documentation helper in one binary, with each capability toggled by environment variables.
server
The Fluvie render API server.