Skip to content

super3-9dev/ClaraN

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

173 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ClaraN

Your fully local AI Superstack - Privacy-First, On-Premises, Limitless

ClaraN isn't just another chat UI. It's a complete AI ecosystem that runs 100% on your machines.

This is a hardfork of the awesome project https://github.com/badboysm890/ClaraVerse

Tech Stack

  • Tauri for building Desktop- and Mobile apps as a hybrid and secure framework - using Rust and web technologies
  • Qwik web framework for building performant Web UIs
  • Nodejs Javascript for tooling
  • DaisyUI for faster, cleaner and simple tailwind CSS UI development

Supported environments

πŸ–₯️ Desktop App

operation system supported bundle
MacOS βœ… aarch64.dmg (aarch64.app.tar.gz), x64.dmg (x64.app.tar.gz)
Apple Store N/A please buy me a coffee for an apple developer license $99
Windows βœ… x64-setup.exe, x64_en-US.msi
Linux βœ… amd64.AppImage, amd64.deb, x86_64.rpm

Troubleshooting

  • Failed to run AppImage on Ubuntu: AppImages require FUSE to run
sudo apt-get install libfuse2
  • Failed to run AppImage on Debian: The installation is failing because of missing libraries. Any clue how to fix?

  • Failed to build android on MacOS pnpm android:build: set the OPENSSL_DIR env

1a. find the path with brew

brew info openssl@3

1b. or find the path with whereis

whereis openssl
  1. set path in your environment, e.g. ~/.zshrc
export OPENSSL_DIR=/usr/local/Cellar/openssl@3/3.5.1
  • Installation blocked on MacOS

Open settings then Security & Privacy -> scroll to Security and force open option to allow installation

When start the app go also to the settings then Security & Privacy -> scroll to Security and force open option to allow installation

πŸ“± Mobile App

operation system supported bundle
Android βœ… apk, aab
iOS βœ… is planned

πŸ› οΈ Development Setup

# Install once the global dependency
npm install -g pnpm

# Install dependencies
pnpm install

Web app

pnpm web:dev

Desktop app

pnpm dev

Android mobile app

  • prerequisites: openjdk, Android Studio with one installed emulator
pnpm android:dev

iOS mobile app

  • prerequisites: XCode
pnpm ios:dev

πŸ“Έ Visual Showcase

πŸ–ΌοΈ Click to see screenshots

πŸ“± Mobile Chat

System Chat Sidebar Keyboard
Android Android chat version Android sidebar Android keyboard
iOS iOS chat version

πŸ–₯️ Desktop Chat

System Chat Collapsed sidebar
MacOS MacOS desktop chat version Assistent wiht collapsed sidebar

πŸ†š ClaraN vs The Competition

Feature ClaraN ClaraVerse OpenWebUI LibreChat Ollama WebUI
πŸ’» 100% Local Stack βœ… Complete βœ… Complete βœ… Yes βœ… Yes βœ… Basic
🧩 Visual App Builder ❌ No βœ… Built-in ❌ No ❌ No ❌ No
πŸ”„ Native Automation ❌ No βœ… N8N Integrated ❌ No ❌ No ❌ No
🧠 Agent Builder ❌ No βœ… Visual Designer ❌ No ❌ No ❌ No
🎨 Image Generation ❌ No βœ… ComfyUI βœ… Basic DALL-E ❌ No ❌ No
🧱 Widget System ❌ No βœ… Dynamic Dashboard ❌ No βœ… Basic ❌ No
πŸ”§ Code Execution ❌ No βœ… OpenInterpreter ❌ No ❌ No ❌ No
πŸ“± Mobile App βœ… Tauri - Android [iOS] ❌ in progress ❌ Web Only ❌ Web Only ❌ Web Only
πŸ–₯️ Desktop App βœ… Tauri - MacOS Linux Windows βœ… Electron ❌ Web Only ❌ Web Only ❌ Web Only

πŸ—“οΈ Release Timeline & Roadmap

🎯 Current Release Status

Component Status Description
🧠 Clara AI Assistant 0.4.0 open Chat Interface with multi-provider support
🐳 Docker Deployment 0.3.0 in progress One-command local deployment
🧠 Clara AI Assistant βœ… 0.2.0 Released Chat Interface with ollama provider support
🧠 Clara AI Assistant βœ… 0.1.1 Released Started with UI layout
πŸ“± Mobile Apps βœ… Released Android support, iOS (simulator only)
πŸ–₯️ Desktop Apps βœ… Released Windows, macOS, Linux support

πŸ” Privacy & Security

πŸ›‘οΈ Privacy Feature Status Details
Local Processing βœ… 100% All AI models run on your machines
No Telemetry βœ… Zero No data collection or phone home
Open Source βœ… Full Complete codebase transparency
Self-Hosted βœ… Complete Own your entire AI stack
No Cloud APIs βœ… Optional Cloud providers only if you choose
Encrypted Storage βœ… Built-in Local data encrypted by default

🌍 Community & Support

Any help is welcome ...

Join the ClaraN Community


GitHub
Issue - PR - Board

How to run on mobile Android

  1. Install termux

2a. networkless mode:

install ollama local AI server

pkg install ollama

run ollama

ollama serve

then pull AI model (other models will come)

ollama pull llama3.2

2b. shared ollama server:

  • setup ssh port forward

How to build a new release

  1. Clone the project
git clone git@github.com:<USER>/ClaraN.git
  1. Create a tag and push it, e.g. v1.0.0, which will trigger the github CI
git tag v1.0.0 && git push origin v1.0.0
  1. A new draft release will created and you can add more informations about the changes, here https://github.com/USER/ClaraN/releases

  2. Ensure that the github secrets are setup for the mobile builds: https://github.com/USER/ClaraN/settings/secrets/actions

  3. Ready? Click: publish release

πŸ“œ License

ClaraN is open-source software licensed under the MIT License. This means you can:

  • βœ… Use it commercially
  • βœ… Modify and distribute
  • βœ… Use it privately
  • βœ… Contribute back to the community

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors