~/codigoagente
Open source tools

ArtCraft: the open source IDE for AI image and video with control over pose, camera and scene

At the end of the article you'll find the install command, a ready-to-paste prompt and a .md to download.

ArtCraft is an open source desktop app that works as an IDE for AI image and video creation: instead of typing a prompt and hoping, you build the scene on a 2D canvas or in 3D space, pose your characters, pick the camera angle and only then generate. It is licensed MIT or Apache 2.0, runs on Windows, macOS and Linux, and lets you pay with its own credits or with your own fal API key.

This guide covers exactly what it does, how it decides which service generates each image (and who bills you), what it really costs compared with model aggregator sites, how to install it, and one security detail about where it stores your key.

Character Posing: pose a mannequin, lock the camera and the model keeps the composition · frames from the official ArtCraft demo

What ArtCraft is and who makes it

  • Repository: github.com/storytold/artcraft. We analyzed commit de571bb from November 20, 2026; the desktop app declares version 0.42.1 there.
  • License: dual, MIT or Apache 2.0, your choice. The ArtCraft name and logo are trademarks and are not covered: you can modify the code and use it for clients, but not ship your build under their brand.
  • Stack: Rust with Tauri 2 for the native side, React with Vite and Nx for the UI, SQLite for the local task queue, and three.js with ammo.js (physics) for 3D scenes.
  • Who builds it: the ArtCraft team; its servers answer at api.storyteller.ai. Their roadmap says goal number one is to beat AI model aggregator websites and, longer term, to depend less on their own hosted services.

The core idea is moving from *prompting* to *crafting*: the prompt is still there, but the scene you build is what drives the result. That fixes the classic AI generation problem where every attempt changes the character's face, the framing or the room.

What you can do with ArtCraft

The features that stand out against a regular generation website:

  1. Character Posing: pose an articulated mannequin, place the camera and generate. The character comes out in that pose and framing.
  2. Character Identity Transfer: use the mannequin to guide where and how a specific character appears, keeping their identity across shots.
  3. Image to Location: turn an image into a consistent set and shoot several angles inside the same room.
  4. Layered 2D and 3D compositing: backgrounds, foregrounds and props with real depth, background removal included.
  5. Image to 3D Mesh and kitbashing: turn an image into a 3D object you can rotate and frame, or combine 3D asset kits to block out the scene.
  6. Mask editing and inpainting, text to image, prompted editing and image to video.

ArtCraft's own catalog lists 62 models in its README: 16 image (Nano Banana, GPT Image, FLUX, Seedream), 25 video (Seedance, Kling, Veo, Sora, Vidu, MiniMax), 5 music and sound (Suno, Seed Audio), 11 3D mesh (Hunyuan 3D, Tripo3D, Meshy, Rodin) and 5 world models with Gaussian splats (Marble, TripoSplat). Some are flagged as disabled or restricted, so check the in-app list before planning a project around one.

How it decides who generates and who bills you

This is the part the homepage doesn't explain and the one that matters for your wallet. Reading generate_image_command.rs and handle_router.rs, every generation takes one of three paths:

The three paths of an ArtCraft generation, taken from the code and the pricing page · codigoagente
  1. ArtCraft credits (default). If you don't pick a provider, the request goes to their servers (api.storyteller.ai) and spends credits from your account. It is the only path with the full catalog.
  2. Your API key (bring your own key). Today it only works with fal: the router only maps that key, although the code already reserves a slot for Replicate. In the current code the models that accept fal are Flux 1 Dev, Flux 1 Schnell, Nano Banana 2 and Nano Banana Pro. If the key is missing, the app says so clearly ("You need to set a FAL api key").
  3. Your web account. For Grok, Midjourney, Sora and World Labs you sign in inside the app and it uses the subscription you already pay for.

You change the provider order in Settings → Provider Priority.

What ArtCraft really costs

The app is free and so is the code. What you pay for is generation. Prices checked on getartcraft.com/pricing on November 21, 2026:

OptionWhat you payMonthly creditsWhen to pick it
Your fal key onlyWhat fal charges per image, no feeN/AYou generate little or want to try Flux and Nano Banana without a subscription.
Your Midjourney, Grok or Sora accountThe subscription you already haveN/AYou already pay for one and want it with 3D staging.
Basic10 USD/month, or 8 USD/month billed yearly (96 USD)1,000Occasional use of the full catalog, mostly images.
Pro35 USD/month, or 28 USD/month billed yearly (336 USD)3,750Frequent video.
Max60 USD/month, or 48 USD/month billed yearly (576 USD)6,600Daily video production.

They also sell one-off credit packs, but the page doesn't show their price. For a small business, the cheapest way to start is a fal key: no fee, you pay only for what you generate, checking each model's price on fal's site. If you already pay for Midjourney, using it inside ArtCraft costs nothing extra.

Install ArtCraft on Windows, macOS or Linux

The normal route is the installer from getartcraft.com or the GitHub releases. On Linux there are AppImage, DEB, RPM, Arch, Flatpak and tar.gz packages for x86_64 and ARM64.

Then:

  1. Open ArtCraft and sign in (or sign up) from the start dialog; you can approve the login on the website or with a QR code.
  2. If you'll use your fal key, create it in your fal dashboard and paste it in the app's provider settings.
  3. Pick the model and provider in the selector before pressing Generate.

To build it yourself you need Rust, Node.js 20 or later and tauri-cli 2.10. On macOS and Linux one launcher starts the UI and the native app together:

terminalsh
git clone https://github.com/storytold/artcraft
cd artcraft
./script/artcraft/unix_dev.sh

On Windows you use two terminals: .\script\artcraft\windows_frontend_dev.ps1 and .\script\artcraft\windows_rust_dev.ps1. The backend and website live in a separate repository (artcraft-services), so building the app does not give you ArtCraft without its cloud: login and credits still go through their servers.

A transparency note: this time we couldn't open the desktop app in our test environment, so everything above comes from the code, the repository docs and the pricing page, and the UI images are frames from the official demo.

Security: where it stores your fal key

ArtCraft saves your API key in a plain text file in your user folder: ~/Artcraft/credentials/fal.api_key.txt (and the Grok, Midjourney and Runway web sessions as .toml files in the same folder). It isn't encrypted, so:

  • Don't sync ~/Artcraft with Dropbox, OneDrive or a repository.
  • Set a spending limit on the key in your fal dashboard.
  • On a shared or client machine, delete that folder when you're done or use a separate key per project.

The good part: the repository docs explain that the ArtCraft session cookie stays on the native (Rust) side and never reaches the web UI or its local storage, and that tokens aren't written to the logs.

Common errors

  • "You need to set a FAL api key": you chose fal as the provider without pasting the key, or picked a video or 3D model that doesn't work with your key yet. Switch to ArtCraft credits or a compatible image model.
  • "No configured provider available for image generation": the model has no configured provider. Sign in to ArtCraft or add your key.
  • A model from the README isn't listed: it's flagged as disabled (†) or restricted (‡) in the catalog.
  • When building, Tauri opens a stale URL or can't connect: use unix_dev.sh instead of the two legacy scripts; it picks a free port from 5193 up and hands Tauri that exact address.

Frequently asked questions

Is ArtCraft free? The app and the code, yes (MIT or Apache 2.0). Generating images or video costs ArtCraft credits, whatever fal charges for your key, or the subscription of the service you connect.

Does it work offline or with local models? No. Today every path calls a cloud service. The roadmap mentions removing the dependency on their servers, but the current code has no local model support.

Can I use what I generate for clients? The software license allows it. Rights over each image or video depend on the terms of the model and provider you use (fal, Midjourney, Sora…): check them before delivering.

Is it good for social media videos? Yes: you generate shots with a consistent character and set, then animate them with image to video. If you'd rather produce videos with code and agents, see how to make AI videos with Claude Code or Codex or OpenMontage.

Conclusion

ArtCraft makes sense when you need control: the same character across shots, an exact pose or a scene with depth. If you only want one-off images, a generation website is enough. To start without a fee, download it, connect a fal key with a spending limit and try Character Posing with Flux 1 Schnell; if it convinces you and you'll make video, consider the Pro plan. For more open source tools that save you license fees, see FigCraft for UI design and Dioramas for 3D websites.

// resource · use it now

ArtCraft ready to use on your PC

Download the installer or build it from source, and paste the prompt for your case into Claude Code (or another agent) to get it ready without exposing your fal key.

Repository license: MIT or Apache-2.0 (name and logo: trademark)

1. Install

Installer (Windows, macOS, Linux)
https://getartcraft.com/
https://github.com/storytold/artcraft/releases
Build on macOS or Linux
git clone https://github.com/storytold/artcraft
cd artcraft
./script/artcraft/unix_dev.sh
Build on Windows (two terminals)
.\script\artcraft\windows_frontend_dev.ps1
.\script\artcraft\windows_rust_dev.ps1

2. Pick your case

Paste this prompt into your agent
I want to start using ArtCraft (https://github.com/storytold/artcraft) on this PC to create images with consistent characters and scenes, spending as little as possible.

1. Tell me which package from https://getartcraft.com/ or the GitHub releases matches my operating system and architecture, and wait for my OK before downloading anything.
2. Once it's installed, explain how to create a fal API key with a low monthly spending limit. Don't ask me for the key or write it to any file: I'll paste it myself in ArtCraft's provider settings.
3. Check that the ~/Artcraft folder is not inside Dropbox, OneDrive, iCloud or a git repository; warn me if it is.
4. Give me a first step-by-step exercise with Character Posing and Flux 1 Schnell via fal: mannequin, camera, prompt and generate.

3. How to use it

  1. Install ArtCraft and sign in from the start dialog (website or QR code).
  2. Create the fal key with a spending limit and paste it in the provider settings.
  3. In **Settings → Provider Priority** put fal first if you want to spend from your key before credits.
  4. Try Character Posing with Flux 1 Schnell and check in fal what it cost.
Prompt and short guide in one fileRepositorystorytold/artcraft

Help us grow

codigoagente is free, with no paywalls. If this article helped you, any of these keeps the blog going.

// newsletter

One email a week with the repos worth your time

The week's new articles, tested against real code. No spam; unsubscribe in one click.

PeakCut cuts long videos and YouTube, Twitch or Kick streams into 9:16 clips with word-by-word captions. Install guide, real costs and a Spanish-language test.
  • Free alternatives to paid apps
  • Run it on your server
read article
Slopus is a GPL-3.0 desktop app that plans, generates and edits images, video and music on your GPU. Agent, local generators and timeline, no FFmpeg bundled.
  • Claude Code
  • Free alternatives to paid apps
read article
Breakscale is an MIT system design simulator: build your architecture, raise the traffic and watch why it fails. Free on the web, in VS Code and via MCP.
  • Claude Code
  • Free alternatives to paid apps
read article