Skip to content

Repository files navigation

Asumi Agent

English | 中文 | 日本語

Status Stage Build Status

男性は少し苦手です。先輩からは、いやらしさを感じなかったので……。

A desktop AI Agent tool inspired by the character 錦 あすみ (Asumi Nishiki) from Madosoft's Hamidashi Creative, designed to assist and accompany users in their daily workflow.

Features

The project is in early development, starting from macOS, with the following planned features:

  • Menu Bar: Display an Asumi-themed icon in the menu bar with contextual actions.
  • Multi-Model Support: Connect to various LLM providers (cloud API / local models) for flexible conversation and interactions.
  • Desktop Pet: Show Asumi's character on the desktop with text-based interaction.
  • Voice Output: TTS-powered voice synthesis in Asumi's character voice for immersive interaction.
  • Transparent Companion: Two modes — persistent (always on screen) and transparent (appears only under certain conditions).
  • Screen Understanding: Periodically capture screen content, analyze it via multimodal LLM, and let Asumi react to what you're doing.
  • Quick Command Execution: Define shortcuts or scripts for Asumi to execute, providing practical utility.
  • Audio Playback: Built-in audio clips related to Asumi for atmosphere.
  • Quick Launch: Summon a mini chat window via global hotkey for rapid interaction.
  • Information Retrieval: Let Asumi periodically fetch and summarize information from specified sources (websites/social media) to keep you updated.
  • File Processing: Drag-and-drop files for Asumi to process — write scripts or skills for automated file organization.
  • Asumi Skill: Allow users to specify Asumi's tone and style for output formatting.
  • Third Party Skill: Allow users to integrate third-party skills to extend Asumi's capabilities.

Tech Stack

  • Desktop Framework: Tauri 2
  • Frontend: React + TypeScript + TailwindCSS
  • Backend Language: Rust

Build from Source Code

macOS

# Install Xcode CLI (if not installed)
xcode-select --install

# Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Press Enter to select default options during installation, then restart terminal or run source $HOME/.cargo/env

# Install node and pnpm
# node can be installed by Homebrew or nvm
brew install node pnpm

# Clone the repo
git clone https://github.com/jayi0908/Asumi-Agent.git
cd Asumi-Agent
# Build front-end dependency
pnpm install

# Run in dev mode
pnpm tauri dev

# Build released version
pnpm tauri build

Acknowledgements

License

This project is open source under the GPL-2.0 License.

About

Desktop pet with agent using image of Nishiki Asumi in Hamidashi Creative.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages