Skip to content
Tatsumi

Tatsumi

Tatsumi (hereinafter the “Application”) is a desktop application for generating AI character art using Google’s Gemini image model.

1. User Documentation

Section titled “1. User Documentation”

Tatsumi is distributed as a desktop app and requires a Google Gemini API key.

Supported generation modes:

  1. Avatar: portrait/avatar generation with 1:1 aspect ratio.
  2. Art: widescreen generation with 16:9 aspect ratio.
  3. Replace: upload an image and regenerate based on an edit prompt.

Threading and output features:

  1. Conversations are stored as local threads between sessions.
  2. You can send follow-up prompts, retry results, and edit previous prompts.
  3. Each response exposes model reasoning and token cost details.
  4. Generated images can be downloaded from the conversation view.

2. Technical Documentation

Section titled “2. Technical Documentation”

Tatsumi uses a Tauri desktop runtime with a React + Vite frontend and Rust backend commands.

Local development:

  1. Install dependencies with pnpm install.
  2. Start development with pnpm tauri dev.
  3. Build frontend/web assets with pnpm build.
  4. Build desktop bundles with pnpm tauri build.
  5. Windows-targeted build uses pnpm build:windows.

Implementation notes:

  1. Frontend UI lives under src/ with modular components for thread views, input, settings, and message rendering.
  2. Tauri backend code lives under src-tauri/src/, including Gemini integration and local storage handling.
  3. App configuration is defined in src-tauri/tauri.conf.json.
Section titled “3. Legal Documentation”

Project policy files reference global documentation:

  1. License: https://docs.spellware.dev/#/license
  2. Terms: https://docs.spellware.dev/#/terms
  3. Privacy: https://docs.spellware.dev/#/privacy
  4. Security: https://docs.spellware.dev/#/security

Copyright is held by Naomi Carrigan.

4. Contributing Documentation

Section titled “4. Contributing Documentation”

Contributions are accepted through pull requests per the repository contributing guidelines and code of conduct.

Before opening a pull request:

  1. Run pnpm install.
  2. Run pnpm lint.
  3. Run pnpm build.
  4. Verify desktop app behavior with pnpm tauri dev.

Feedback and bug reports are handled in the #bug-reports and #feature-requests forum channels in our Discord community.