Tanish Manku 335015d9e2 Dev infra: fully-local generation and gallery for the dev stack
Closes the two gaps found smoke-testing the local stack: an empty gallery
(zero media_files rows, media URLs hardcoded to the remote r2.dev bucket)
and generation flows that could not complete (omni_gen calls providers
synchronously in the handler, so dummy keys meant a 500 after billing;
the webapp blocked submits earlier anyway because signup grants no wallet).

Backend (all development-only):
- CDN_BASE_URL env override in cdn_link.rs (host-only, validated loudly;
  precedence over the compiled-in hosts for every domain/env) and a
  dev-gated actix-files mount serving LOCAL_MEDIA_ROOT/media at /media,
  mirroring the public bucket layout - media URLs in API responses resolve
  against the backend itself
- DEV_FAKE_GENERATION flag on ServerState (easyenv bool, forced off outside
  Development): the omni_gen image/video pipelines skip the external
  provider call and return a synthetic Fal enqueue (external id fake_<uuid>),
  so billing, prompt insert, and the pending generic_inference_jobs row all
  stay real
- dev_fake_generation_resolver_thread: polls pending fake_ jobs (new
  runtime-query list_pending_fake_generation_jobs in mysql_queries) and
  after DEV_FAKE_GENERATION_RESOLVE_SECS (default 6s) marks them
  complete_success with a media_files row backed by a test_data asset
  copied under LOCAL_MEDIA_ROOT (mp4 results get -thumb.jpg/-thumb.gif
  siblings since the thumbnail job never runs locally), or complete_failure
  via the existing simulate_artcraft_failure prompt triggers (category word
  supported, e.g. "simulate_artcraft_failure face_not_detected")

Bootstrap/seeds (PS + bash kept in lockstep):
- seed_demo_user seeds an artcraft wallet (DEMO_CREDITS, default 100k
  banked + ledger rows; idempotent top-up) - signup creates no wallet and
  the webapp gates generate on balance, which is why submits went nowhere
- seed_demo_user also seeds 6 gallery images (test_data jpgs) with objects
  under .devstack/media in the exact bucket fan-out layout
- fixed the already-exists detection in seed_demo_user: create_account
  returns error_type, not error_code, so re-runs died on UsernameTaken
- generated secrets env gains DEV_FAKE_GENERATION/CDN_BASE_URL/
  LOCAL_MEDIA_ROOT (appended to existing files on bootstrap re-runs);
  stale "providers are only contacted by workers" comments corrected
- doctor checks wallet balance, media rows, and the new secrets keys

Docs: dev_setup_local_stack.md documents the new flags, corrects the
sync-provider-call and upload-500 claims, updates the seams table and
verification checklist; storyteller_web CLAUDE.md video model examples
fixed (seedance_2p0_fast_g -> seedance_2p0_fast).

Verified E2E on this machine: gallery lists 8 items on localhost URLs;
image and video submits go pending ~6s then complete with locally-served
results (mp4 + gif preview 200); failure trigger yields complete_failure
with category face_not_detected; credits genuinely deducted (100000 ->
99932); doctor 0 failures / 0 warnings.
2026-07-29 20:48:31 -07:00
2026-07-10 03:02:09 -04:00
2026-03-16 22:43:50 -04:00
2026-07-12 15:23:58 -04:00
2026-01-19 23:08:39 -05:00
2026-06-30 10:40:28 -04:00
2026-05-23 11:26:14 -04:00
2026-01-19 23:08:39 -05:00
2026-07-08 02:26:52 -04:00
2026-01-19 23:08:39 -05:00
2026-01-06 12:27:34 -05:00
2026-01-06 12:22:46 -05:00

The IDE for artists.

Discord YouTube X LinkedIn


ArtCraft

ArtCraft is the IDE for interactive AI image and video creation. We turn prompting into crafting, so your ideas become a form of tangible expression and computing. This is Adobe Photoshop for everyone, and we're giving away the source code!

Show, Don't Tell: Advanced Crafting Features

Text-to-image is great, but artists need control. It's important to know what your image will look like before you generate it, and it's vitally important to achieve consistency and repeatability.

Feature Demo + Explanation
Image to Location Video Placing virtual actors into physical environments establishes single-location consistency. You can film multiple shots within a room without having things disappear.
3D Image Compositing Video Use images (backdrops, foreground elements, props, etc.) in scenes with depth and blend them naturally together. Just a couple of images usually leads to great compositions.
2D Image Compositing Video Use images, background removal, layers, and simple drawing tools to precisely compose a scene.
Image to 3D Mesh Video It's almost impossible to lay out complicated objects or block complicated scenes; turning images into 3D helps position elements exactingly and intentionally.
Character Posing Video You can dynamically pose your characters to achieve the precise character, scene, and camera blocking before calling "action".
Scene Blocking w/ Kit Bashing Video Use 3D asset kits to precisely block out your scene: get the correct angles, object positions, and rich depth layering you can't with text prompting.
Character Identity Transfer Video Use mannequins as simple 3D ControlNets for posing any character.
Background Removal Video Remove backgrounds from images to make them useful in 2D or 3D compositing. They can be props, layers, or backdrops.
Mixed Asset Crafting Video You can use image cutouts, worlds, and simple 3D meshes all together to precisely and intentionally lay out your scenes.
Scene Blocking (preview coming soon)
Canvas Editing (preview coming soon)
Scene Relighting (preview coming soon)

Note: all of the above videos were generated for free with Grok Video; the cost to build this README was negligible.

Quick and Easy Prompting

We haven't abandoned text-to-asset generation for quick prototyping and ideation. We support every popular workflow in a first class fashion.

Feature Demo + Explanation
Text to Image Video Text prompt over a dozen different image models.
Image Editing Video Edit with Nano Banana Pro and GPT Image 1.5.
Image Editing Video Use inpainting, drawing, masking, etc. to edit images.
Image to Video Video Image to video with lots of different options and controls.
Image Inpainting (preview coming soon)
Image Ingredients (preview coming soon)

Models and Providers Supported within Artcraft

Provider Features
Artcraft Nano Banana, Nano Banana Pro, GPT-Image-1 / 1.5, Seedance 1.0 Lite / 1.5 Pro / 2.0, Seedream 4 / 4.5, Flux 1.1 / Kontext, Veo 2 / 3 / 3.1, Kling 1.6 / 2.1 / 2.5 / 2.6, Sora 2 / Pro, Hunyuan 3d 2 / 3
Grok Grok Imagine, Grok Video
Midjourney Image Gen (all versions)
Sora Sora 1, Sora 2, GPT-Image-1
WorldLabs Marble (Gaussian Splat World Generation)

We're going to be adding the following providers soon: Kling (via Kling website accounts), Google (via API keys), Runway (via website account), Luma (via website account).

We're potentially interested in adding other aggregators for those who already have subscriptions and credits at those providers, for example: OpenArt, FreePik, etc.

Downloads

Documentation

Languages
Rust 59.4%
TypeScript 39.3%
JavaScript 0.7%
Python 0.3%
CSS 0.2%
Other 0.1%