mirror of
https://github.com/storytold/artcraft.git
synced 2026-11-14 22:02:36 +00:00
Tanish Manku
f872ca4a6e
Make failure modes legible to both the LLM and the user:
errors.rs:
- ErrorCode enum: artcraft_not_installed, not_logged_in,
session_expired, backend_unavailable, invalid_params,
generation_timeout, generation_failed, reference_image_failed,
internal.
- ToolError { error_code, message, remediation, details? } that
serializes as JSON in CallToolResult::error content blocks.
- not_logged_in() detects whether the app is installed
(/Applications/ArtCraft.app or the cache dir) and returns the
appropriate code + remediation text.
creds.rs:
- load_session() now returns Result<_, ToolError>. The user sees a
proper sign-in remediation instead of a generic anyhow message.
tools/check_artcraft_connection.rs (new):
- Always succeeds, never errors. Reports desktop_app_installed,
signed_in, session_valid, error_code, remediation. Detects expired
sessions by making a cheap authenticated get_session_credits call.
tools/list_image_models.rs:
- 401/403 from the API now maps to session_expired.
All existing tools converted from anyhow::Result to Result<_, ToolError>
with appropriate error codes per failure path.
server.rs:
- Updated instructions teach Claude how to react to each error code
(open desktop app and sign in, download from getartcraft.com, etc.)
and to call check_artcraft_connection when troubleshooting.
- error_result() now serializes the full ToolError struct as JSON
inside the error content block.
main.rs:
- New '--check' / '-c' CLI flag prints a human-readable diagnostic to
stdout and exits, useful when the user can't see the Artcraft tools
in Claude and wants to debug from a terminal without round-tripping
through MCP.
The IDE for artists.
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 | |
| 3D Image Compositing | |
| 2D Image Compositing | |
| Image to 3D Mesh | |
| Character Posing | |
| Scene Blocking w/ Kit Bashing | |
| Character Identity Transfer | |
| Background Removal | |
| Mixed Asset Crafting |  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 | |
| Image Editing | |
| Image Editing | |
| Image to Video | |
| 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
- Visit our website for the stable Windows and MacOS releases
- Or you can grab a more recent Windows and MacOS build directly
- Linux requires building from source for now