5 分钟跑通 ArtCraft:一条脚本启动 AI 图像生成桌面应用
【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/GitHub_Trending/ar/artcraft
ArtCraft 是一个面向艺术家、设计师和影视创作者的 AI 图像生成与视频创作桌面应用。它的官方定位是"The IDE for artists":你不仅可以输入 Prompt 出图,还能在 2D 画布上合成、在 3D 空间里布景,再自由选择 62+ 个生成模型。最短路径:下载官方安装包直接体验;或克隆源码后运行一条脚本,前端热更新和 Rust 编译一起拉起,几分钟内打开应用窗口。
能力全景:能拿它做什么
| 创作场景 | 可选模型/技术 |
|---|---|
| 文生图 | Nano Banana、GPT Image、FLUX、Seedream |
| 图生视频 | Kling、Veo、Sora、Vidu、Seedance |
| 3D 场景编排 | 图像到 3D 合成、角色定位与姿态、Kitbashing 布光 |
| 音频/音乐 | Suno Music、Suno Remix、Seed Audio |
| 3D 网格 | Hunyuan 3D、Tripo3D、Meshy、Rodin |
| 世界生成 | Marble(World Labs)、TripoSplat |
它和纯 Prompt 工具的区别在于"先搭后生成":构图、角色身份、机位都可以在生成之前用可视化工具精确摆好,让每次结果可重复、可微调,而不是靠掷骰子。
选路指引:先装好还是先写代码
只打算创作、不碰代码:走官方安装包,几分钟出第一张图。想改功能、提交代码或研究实现:走源码构建,你需要提前备好 Rust、Tauri CLI 和 Node.js。两条路线互不冲突,可以先下载体验,回头再克隆仓库。
路线 A:直接体验
- 打开 getartcraft.com,下载 Windows 或 macOS 安装包并安装。
- 启动应用,注册或登录账号。
- 在 Prompt 框输入第一句话,生成你的第一张图。
路线 B:源码构建
环境清单
| 组件 | 版本 | 安装方式 |
|---|---|---|
| Rust | 最新稳定版 | 通过 rustup 安装 |
| Node.js | 20+(已验证 v24.13.0) | 官网或 nvm |
| Tauri CLI | 2.10.0+ | cargo install tauri-cli --version "^2" --locked |
Nx 和 Vite 等前端依赖由 npm 本地安装即可,无需全局装 Nx。
一键启动
克隆仓库,然后在仓库根目录运行开发脚本,它会检查前端依赖、自动寻找可用端口并绑定 Vite,再把精确的devUrl传给 Tauri:
git clone https://gitcode.com/GitHub_Trending/ar/artcraft cd artcraft && ./script/artcraft/unix_dev.sh默认从5193端口开始探测;端口被占时自动顺延,也可用环境变量固定:ARTCRAFT_DEV_PORT=6200 ./script/artcraft/unix_dev.sh。首次启动要等 Rust 编译整个 workspace,耗时较长属正常现象,之后增量编译会快很多。
启动成功的判断依据
- 桌面窗口弹出,能看到 Prompt 输入区和模型选择器。
- 终端显示 Vite 已绑定
127.0.0.1的5193(或顺延后的端口),HTTP 与 HMR 共用该端口;Rust 端走原生 Tauri IPC,不占额外端口。 - 改一行前端 TS/CSS,页面立刻热更新;改 Rust 代码则触发重新编译并重启应用。
跑起来后先做什么
- 最低成本试一次:在 Prompt 框敲一句话,挑一个图像模型生成。几秒到几十秒内你会看到出图,并体验模型切换和出图对比。
- 接着点进 3D 场景工具:把一个图像放进 3D 空间,摆好机位和角色再交给模型生成,直观感受"先搭景、后生成"的工作流。
生产构建与关键目录
打包安装包只需一条命令,脚本会自动设置VITE_ENVIRONMENT_TYPE=production和SQLX_OFFLINE=true,产物输出到crates/desktop/artcraft/target/release/:
./script/artcraft/unix_build.sh| 目录 | 职责 |
|---|---|
crates/desktop/artcraft/ | Tauri 主应用(配置、图标、能力声明) |
crates/api_clients/ | 各 AI 提供商的 Rust 客户端(fal、Grok、Sora 等) |
frontend/apps/artcraft/ | React + Vite 前端主应用 |
frontend/libs/ | 共享组件库(promptbox、moodboard、video-editor 等) |
| script/artcraft/ | 开发/构建/预览脚本 |
| _database/sql/artcraft_migrations/ | SQLite 任务库迁移文件 |
排错速查
| 现象 | 解法 |
|---|---|
| 5193 端口被占用 | 脚本自动顺延找可用端口;或设ARTCRAFT_DEV_PORT固定起始端口 |
| 首次编译非常慢 | 正常现象,Rust 在编译整个 workspace;后续增量编译明显加快 |
| 提示缺前端依赖 | 脚本检测到node_modules/vite缺失时会自动npm install;也可手动在frontend/下执行 |
| Linux 上窗口/渲染异常 | 启动脚本已内置 WebKit 兼容补丁,确认是通过unix_dev.sh启动而非手动拉起 |
| 不想起数据库只做 Rust 检查 | 运行SQLX_OFFLINE=true cargo check -p artcraft |
| Ctrl+C 后想彻底停干净 | 启动器会一并关闭前端、Rust 监视器和桌面应用,无需逐个杀进程 |
更多开发细节可查 _docs/dev_setup.md 和 docs/。
跑起来之后,别急着研究配置——在 Prompt 框写下你心里想的那个画面,先拿到第一张图 🎨。
【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/GitHub_Trending/ar/artcraft
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考