---
title: Tatsumi
---

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

## 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

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`.

## 3. Legal Documentation

Project policy files reference global documentation:

1. License: `https://docs.nhcarrigan.com/#/license`
2. Terms: `https://docs.nhcarrigan.com/#/terms`
3. Privacy: `https://docs.nhcarrigan.com/#/privacy`
4. Security: `https://docs.nhcarrigan.com/#/security`

Copyright is held by Naomi Carrigan.

## 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 via `https://support.nhcarrigan.com`.