Skip to content

Gakuseei/Aria

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

42 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation


Aria Logo



🌹 ARIA

Uncensored AI Roleplay β€’ 100% Offline β€’ Zero Restrictions

Your AI. Your Rules. Your Privacy.


Version Platform License Offline


Discord Ko-fi



🎭 What is Aria?

Aria is a premium, fully local AI companion platform designed for immersive roleplay, storytelling, and unfiltered conversations.


Offline Β  Design Β  Languages Β  Gold


Caution

⚠️ ALPHA SOFTWARE

This is an early ALPHA release. Expect bugs β€” potentially many. Features may be incomplete, unstable, or change without notice. Your feedback helps shape the future of Aria.

Use at your own risk. Report issues on Discord or GitHub Issues.




✨ Why Aria?


πŸ” Absolute Privacy

Your data never leaves your device. Aria runs entirely offline using Ollama β€” no cloud, no tracking, no subscriptions, no compromises.

🎭 Living Characters

Create AI companions with deep personalities, persistent memories, and evolving relationships. The Passion System adapts responses based on your unique dynamic.

🎨 Premium Experience

Rose-Noir aesthetic with glassmorphism, smooth animations, and OLED optimization. Gold Mode unlocks exclusive visuals for supporters.


Features at a Glance


πŸ’‘
Smart Suggestions
AI-powered prompts

πŸŽ™οΈ
Voice Synthesis
Piper TTS / Zonos

πŸ–ΌοΈ
Image Generation
Stable Diffusion

πŸ“¦
Import/Export
Share characters

🌍
13 Languages
Full localization




πŸš€ Quick Start

Get started in under 5 minutes


Requirements

Component Minimum Recommended
Ollama Download Latest
RAM 8 GB 16 GB+
GPU β€” For faster inference

Download & Install

  1. Download Aria Setup 0.2.5.exe from Releases
  2. Run the installer, Aria sets itself up
  3. Open Aria and you're good to go

Tip

No terminal, no config files. Aria walks you through everything on first launch: Ollama setup, model selection, voice, and character creation.


Developer Setup (from source)

Requires Node.js v18+ (v20+ recommended).

git clone https://github.com/Gakuseei/Aria.git
cd Aria
npm install
npm run dev



πŸ—ΊοΈ Roadmap

Building the ultimate private AI companion


Version Status
v0.2.5 Alpha βœ… Current
v0.5 Alpha 🚧 In Development
v1.0 Beta πŸ“‹ Planned
v2.0 Stable πŸ“‹ Planned

βœ… Completed
  • Voice System β€” TTS with Piper & Zonos
  • Gold Mode β€” Premium visuals for supporters
  • 13 Languages β€” Complete localization
  • Premium Animations β€” Startup sequence & transitions
  • Image Generation β€” Stable Diffusion integration
  • Context Cleaner β€” Smart memory management
  • Ko-fi Integration β€” Direct supporter benefits
  • Windows Installer β€” One-click setup, no terminal needed
  • OLED Toggle β€” Quick-switch Moon/Sun button
🚧 v0.5 Alpha β€” Next Up
Feature Description
πŸ“š Tutorial 2.0 Model recommendations by hardware tier
πŸ’¬ Enhanced Chat Personas, auto-scroll, edit messages
❀️ Passion 2.0 Expanded relationship tiers
πŸ’Ύ Auto Backup Automatic saves after each message
πŸ–ΌοΈ Profile Pictures Character backgrounds & info tab
πŸ”Š Sound Effects Rose-Noir audio feedback
πŸ“‹ v1.0 Beta
Feature Description
πŸŽ“ Onboarding Tour First-time setup walkthrough
🎨 Brand Refresh Refined visual identity
πŸ‘₯ Group Chats Multi-character conversations
πŸ‘οΈ Vision Image understanding (local)
🎀 TTS 2.0 Enhanced emotional voice
βš–οΈ Content Toggle Customizable content preferences
πŸ“‹ v2.0 Stable
Feature Description
πŸ–₯️ Cross-Platform macOS & Linux installers
πŸ₯š Gold Easter Eggs Hidden surprises for supporters
πŸ”Œ Plugin System Community extensions
πŸ“Š Analytics Local usage insights & stats



πŸ› οΈ Technology Stack


Electron
⚑
Desktop Platform



React 18
βš›οΈ
UI Framework



Vite
πŸš€
Build Tool



Tailwind CSS
🎨
Styling



Ollama
πŸ€–
Local AI





🀝 Contribute

We welcome contributors of all experience levels


πŸ›
Bug Reports
Help improve stability

🌐
Translations
Add new languages

πŸ’‘
Features
Share your ideas

πŸ“
Documentation
Improve guides


# Quick contribution workflow
git checkout -b feature/your-feature
git commit -m "Add your feature"
git push origin feature/your-feature
# Open a Pull Request



πŸ’¬ Community

Questions, ideas, or just want to connect?

Discord

Share characters β€’ Get support β€’ Report bugs β€’ Connect with users




πŸ’– Support

If Aria brings you value, consider supporting its development

Ko-fi

Supporters unlock Gold Mode: exclusive visuals, early access, and special recognition




πŸ“œ License

MIT License β€” See LICENSE.md



Made with 🌹 by the Aria Community


GitHub stars Β  Discord