Anima

Anima is built on open-source principles to guarantee security, privacy, and full reproducibility. All sensitive data transformations run locally on your hardware with zero telemetry or unexpected cloud dependencies.

## Key Technical Features & Capabilities
- **One project, one companion. Every project gets a unique familiar generated from a weighted rarity pool. Two developers on the same codebase won't get the same creature.**: Streamlined desktop functionality optimized for macOS and Windows.
- **@nim@ token economy. 1 @nim@ per 1000 tokens spent. Spend on re-rolls and new characters.**: Streamlined desktop functionality optimized for macOS and Windows.
- **Collectible familiar cards. Each project gets a stat card**: species, rarity, power ratings, session history.
- **Cross-session watcher. Rust daemon monitors all active Claude sessions simultaneously. Catches retry loops and read-heavy spirals in real time.**: Streamlined desktop functionality optimized for macOS and Windows.
- **Oracle commentary. Companion fires contextual observations in a speech bubble. Selectable text you can paste straight into the session.**: Streamlined desktop functionality optimized for macOS and Windows.
- ****Voice input.** Bluetooth mic + push-to-talk. Hands-free Claude via WebSocket bridge.**: High-performance integrated capability designed for native Anima workflow.
- ****Session history.** Full session browser. Replay any past conversation. JSONL-backed.**: High-performance integrated capability designed for native Anima workflow.
- ****Native performance.** Tauri v2 + Rust backend. Actual macOS app, 4MB binary.**: High-performance integrated capability designed for native Anima workflow.

## Architecture & Technology Stack
- **Primary Languages**: Swift, Rust
- **Frameworks & UI Runtime**: SwiftUI / AppKit, Tauri 2
- **Build Systems & Tooling**: Cargo
- **Supported Platforms**: macOS 12.0+ (Apple Silicon M1-M4 & Intel x86_64), Windows 10/11 x64, Linux

## System Requirements
| Specification | Minimum Requirement | Recommended Specification |
| :--- | :--- | :--- |
| **Operating System** | macOS 12.0 Monterey / Windows 10 x64 | macOS 14.0+ Sonoma / Windows 11 x64 |
| **Processor Architecture** | Apple Silicon (M1+) or Intel Core i5 x64 | Apple Silicon Unified Memory (M2/M3/M4) |
| **Memory (RAM)** | 4 GB Unified RAM | 8 GB+ High-Speed RAM |
| **Storage Space** | 300 MB available local disk space | 1 GB+ SSD storage |
| **GPU Acceleration** | Metal 2 / DirectX 12 compatible | Apple Neural Engine / Vulkan capable |

## Installation & Setup Guide
### macOS Installation (Recommended)
1. Download the verified `.dmg` release installer directly from CookApps.
2. Open the disk image and drag **Anima.app** into your `/Applications` folder.
3. Launch Anima via Spotlight (`Cmd + Space`) or Launchpad.

Alternatively, install using Homebrew if available:

### Windows Installation
1. Download the official installer package (`.exe` / `.msi`).
2. Run the executable and follow the setup wizard.
3. Launch **Anima** from the Start Menu or desktop shortcut.

### Building from Source (Development Setup)

## How to Use & Workflow
1. **Application Launch & Workspace**: Open Anima to load the responsive native workspace.
2. **Configuration & Preferences**: Press `Cmd + ,` (macOS) or `Ctrl + ,` (Windows) to configure hardware acceleration, custom directories, and display themes.
3. **Primary Operation**: Drag-and-drop source files or input parameters directly into the central window.
4. **Execution & Export**: Initiate the processing pipeline and verify output files saved directly to your chosen local directory.

## Troubleshooting & Common Issues
- **Problem**: macOS Gatekeeper displays *"App is damaged and can't be opened"* or unnotarized developer notice.
  - **Root Cause**: macOS quarantine flag set on binaries downloaded outside the Mac App Store.
  - **Resolution**: Open Terminal and run: