# Koharu

- [Koharu — AI-Powered Local Manga Translation Tool](https://koharu.rs/introduction.md): Koharu automates manga translation with ML-powered text detection, OCR, LLM translation, and generative inpainting — all running locally on your device.
- [How to Install Koharu on Windows, macOS, and Linux](https://koharu.rs/getting-started/install.md): Download and install Koharu on Windows, macOS, or Linux. Get the native desktop app running and ready for your first translation project.
- [Create and Translate Your First Manga Project in Koharu](https://koharu.rs/getting-started/first-project.md): Create a Koharu project, run the full detection-to-inpainting pipeline, review and correct output, typeset your text, and export a finished page.
- [Runtimes, Models, and Hardware Acceleration in Koharu](https://koharu.rs/getting-started/runtimes-and-hardware.md): Learn how Koharu selects GPU backends, which drivers you need for CUDA, ROCm, and Metal, and where downloaded model files are cached on disk.
- [Manage Koharu Projects: Import, Organize, and Back Up Pages](https://koharu.rs/workflow/projects-and-imports.md): Create and organize Koharu projects, import pages from images, archives, or PDFs, manage page order, and keep your work safely backed up.
- [Run Detection, OCR, Translation, and Inpainting in Koharu](https://koharu.rs/workflow/process-pages.md): Select pipeline stages and a page scope to run detection, OCR, translation, and inpainting across one page or your entire Koharu project.
- [Review and Edit OCR and Translation Layers in Koharu](https://koharu.rs/workflow/review-text.md): Correct OCR errors, refine translations, manage layer visibility and ordering, and use undo history to work confidently in Koharu.
- [Use the Koharu Canvas: Pan, Select, Paint, and More](https://koharu.rs/workflow/canvas-basics.md): Pan, zoom, select and transform layers, add text, paint, erase, sample colors, and mask lettering for inpainting using Koharu's canvas tools.
- [Remove Source Lettering and Repair Artwork in Koharu](https://koharu.rs/workflow/cleanup-and-inpainting.md): Remove source lettering automatically or with a manual mask, repair remaining artifacts, and choose the right inpainting model for each job.
- [Typeset Translated Manga Text: Fonts, Layout, and Style](https://koharu.rs/workflow/typesetting.md): Control fonts, writing modes, alignment, fill color, stroke, and automatic size fitting to typeset translated manga text ready for export.
- [Export Translated Manga Pages as PNG or PSD in Koharu](https://koharu.rs/workflow/export.md): Export active or selected Koharu pages as flattened PNG images or layered PSD files ready for sharing, review, or downstream editing in other tools.
- [Set Up Detection, OCR, and Inpainting Models in Koharu](https://koharu.rs/models/vision-and-inpainting.md): Configure detection, OCR, and inpainting models in Koharu's pipeline settings, and understand the trade-offs between speed, quality, and memory usage.
- [Configure Local and Cloud Translation Providers in Koharu](https://koharu.rs/models/translation-providers.md): Set up local GGUF, cloud LLM, machine translation, and OpenAI-compatible providers in Koharu, with credentials stored securely in your OS keychain.
- [Koharu Translation: Language, Instructions, and Generation](https://koharu.rs/models/translation-and-generation.md): Set target language, project-wide instructions, local quantization, and fine-tune generation controls like temperature, thinking mode, and vision input.
- [Set Up Koharu Agent for AI-Assisted Project Editing](https://koharu.rs/agent/setup.md): Sign in with ChatGPT device-code auth, choose a Codex model and reasoning level, and get Koharu Agent ready to work on your project.
- [Inspect, Edit, and Process Manga Projects with Koharu Agent](https://koharu.rs/agent/work-with-projects.md): Learn what Koharu Agent can do, how to write effective requests, and how to review all agent edits before you export your project.
- [Koharu Settings: Pipeline, Providers, Shortcuts, and More](https://koharu.rs/reference/settings.md): Complete reference for every Koharu settings category — appearance, pipeline, providers, translation, typesetting, shortcuts, and storage.
- [Koharu Keyboard Shortcuts: Tools, Navigation, and Editing](https://koharu.rs/reference/keyboard-shortcuts.md): Full reference for all Koharu keyboard shortcuts — canvas tools, navigation gestures, undo/redo, selection, and how to customise bindings.
- [Koharu Supported File Formats and Data Storage Locations](https://koharu.rs/reference/formats-and-data.md): All file formats Koharu can import and export, plus where it stores projects, configuration, credentials, and the model and runtime cache.
- [Troubleshoot Common Koharu Problems and Error Messages](https://koharu.rs/reference/troubleshooting.md): Diagnose and fix the most common Koharu problems — startup failures, model downloads, GPU fallback, OCR quality, inpainting, providers, and more.