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.
What ArtCraft is and who makes it
- Repository: github.com/storytold/artcraft. We analyzed commit
de571bbfrom November 20, 2026; the desktop app declares version0.42.1there. - 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:
- Character Posing: pose an articulated mannequin, place the camera and generate. The character comes out in that pose and framing.
- Character Identity Transfer: use the mannequin to guide where and how a specific character appears, keeping their identity across shots.
- Image to Location: turn an image into a consistent set and shoot several angles inside the same room.
- Layered 2D and 3D compositing: backgrounds, foregrounds and props with real depth, background removal included.
- 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.
- 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:
- 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. - 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").
- 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:
| Option | What you pay | Monthly credits | When to pick it |
|---|---|---|---|
| Your fal key only | What fal charges per image, no fee | N/A | You generate little or want to try Flux and Nano Banana without a subscription. |
| Your Midjourney, Grok or Sora account | The subscription you already have | N/A | You already pay for one and want it with 3D staging. |
| Basic | 10 USD/month, or 8 USD/month billed yearly (96 USD) | 1,000 | Occasional use of the full catalog, mostly images. |
| Pro | 35 USD/month, or 28 USD/month billed yearly (336 USD) | 3,750 | Frequent video. |
| Max | 60 USD/month, or 48 USD/month billed yearly (576 USD) | 6,600 | Daily 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:
- 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.
- If you'll use your fal key, create it in your fal dashboard and paste it in the app's provider settings.
- 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:
git clone https://github.com/storytold/artcraft
cd artcraft
./script/artcraft/unix_dev.shOn 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
~/Artcraftwith 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.shinstead 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
https://getartcraft.com/
https://github.com/storytold/artcraft/releasesgit clone https://github.com/storytold/artcraft
cd artcraft
./script/artcraft/unix_dev.sh.\script\artcraft\windows_frontend_dev.ps1
.\script\artcraft\windows_rust_dev.ps12. Pick your case
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
- Install ArtCraft and sign in from the start dialog (website or QR code).
- Create the fal key with a spending limit and paste it in the provider settings.
- In **Settings → Provider Priority** put fal first if you want to spend from your key before credits.
- Try Character Posing with Flux 1 Schnell and check in fal what it cost.
I want to build ArtCraft (https://github.com/storytold/artcraft) from source to review or adapt it.
1. Read README.md, _docs/dev_setup.md, AGENTS.md and crates/AGENTS.md before touching anything; their rules win.
2. Check that I have Rust, Node.js 20+ and tauri-cli 2.10; if something is missing, give me the install command for my system and wait for my OK.
3. On macOS or Linux start ./script/artcraft/unix_dev.sh; on Windows, the two scripts in script/artcraft in separate terminals.
4. To only check Rust without a database, use SQLX_OFFLINE=true cargo check -p artcraft.
5. Don't touch ~/Artcraft/credentials or paste keys in the chat. If I change anything about providers, tell me which file under crates/desktop/artcraft/src/core/providers holds that logic.
6. Finish with a summary of what depends on ArtCraft's servers (login, credits) and what runs locally.3. How to use it
- Clone the repo into a fixed folder and let the agent check the dependencies.
- Start the launcher and wait for the desktop window to open.
- React changes hot reload; Rust changes restart the app.
- Remember that the ArtCraft name and logo are not covered by the license: if you ship your own build, change them.
Help us grow
codigoagente is free, with no paywalls. If this article helped you, any of these keeps the blog going.
- Share it with someone who'll find it usefulWhatsAppLinkedInXFacebook
- Meet our sponsorSafe Build Labs
More on Open source tools

- Free alternatives to paid apps
- Run it on your server

- Claude Code
- Free alternatives to paid apps

- Claude Code
- Free alternatives to paid apps