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 built from scratch.

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 | :white_check_mark: | 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 | :white_check_mark: | x64-setup.exe, x64_en-US.msi | | Linux | :white_check_mark: | amd64.AppImage, amd64.deb, x86_64.rpm |

<details> <summary>🔥 Click to see Troubleshooting</summary>

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 build:android: set the OPENSSL_DIR env

1a. find the path with brew

brew info openssl@3

1b. or find the path with whereis

whereis openssl

2. 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 <img src="assets/snapshots/macos_allow_dmg.png" width="600px" alt="option to allow installation" />

When start the app go also to the settings then Security & Privacy -> scroll to Security and force open <img src="assets/snapshots/macos_allow_start.png" width="600px" alt="option to allow installation" />

</details>

📱 Mobile App

| operation system | supported | bundle | |---|---|---| | Android | :white_check_mark: | apk, aab | | iOS | :white_check_mark: | is planned |

Scenarios diagram

<img src="assets/arch/scenarios.jpg" alt="scenarios" />

🛠️ Development Setup

# Install once the global dependency
npm install -g pnpm

# Install dependencies
pnpm install

Web app

pnpm dev:web

Desktop app

pnpm dev

Android mobile app

• prerequisites: openjdk, Android Studio with one installed emulator

pnpm dev:android

iOS mobile app

• prerequisites: XCode

pnpm dev:ios

Internationalization

ClaraN supports internationalization for multiple languages: english, deutsch

<details> <summary>🌐 Click to see how to use locales</summary>

Use with i18n:

{$localize`What is New`}

When you are done with your code changes, you can use the i18n-extract command to extract the translations from the code. This will update the message.en.json file.

pnpm i18n-extract

Add new supported locale

Open apps/clara-n/src/locales/consts/locale.ts and append a new locale:

const SUPPORTED_LOCALES = ["en", "de"];

Create a new message.<LANG>.json file in apps/clara-n/src/locales

Integrate new message file in apps/clara-n/src/routes/i18n-utils.ts

</details>

📸 Visual Showcase

<details> <summary><strong>🖼️ Click to see screenshots</strong></summary>

📱 Mobile Chat

<table> <thead> <tr> <th>System</td> <th>Chat</th> <th>Sidebar</th> <th>Keyboard</th> </tr> </thead> <tbody> <!-- Android --> <tr> <td style="vertical-align: baseline;">Android</td> <td><img src="assets/snapshots/android_chat.jpg" width="200px" alt="Android chat version" /></td> <td><img src="assets/snapshots/android_sidebar.jpg" width="200px" alt="Android sidebar" /></td> <td><img src="assets/snapshots/android_chat_keyboard.jpg" width="200px" alt="Android keyboard" /></td> </tr> <!-- iOS --> <tr> <td>iOS</td> <td><img src="assets/snapshots/ios_chat.png" width="200px" alt="iOS chat version" /></td> <td></td> </tr> </tbody> </table>

🖥️ Desktop Chat

<table> <thead> <tr> <th>System</td> <th>Chat</th> <th>Collapsed sidebar</th> </tr> </thead> <tbody> <!-- MacOS --> <tr> <td style="vertical-align: baseline;">MacOS</td> <td><img src="assets/snapshots/desktop_chat.png" width="800px" alt="MacOS desktop chat version" /></td> <td><img src="assets/snapshots/macos_desktop_collapsed_sidebar.png" width="500px" alt="Assistent wiht collapsed sidebar" /></td> </tr> </tbody> </table> </details>

🆚 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 |

Features

• Simple deployment for all mobile and desktop apps
• Get new features easily with the App updater on desktop
• Internationalization depends on the OS locale (EN/ DE)
• Small bundle size and installation with Tauri
• Better developer experience with Qwik and DaisyUI (self-opinionated)
• Secure by using uptodated system native webview

🗓️ 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 ...

<div align="center">

Join the ClaraN Community

<table> <tr> <td align="center"> <img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/github/github-original.svg" width="50"/> <br/><strong>GitHub</strong><br/> <a href="https://github.com/vanvuongngo/ClaraN/issues">Issue</a> - <a href="https://github.com/vanvuongngo/ClaraN/pulls">PR</a> - <a href="https://github.com/users/vanvuongngo/projects/4">Board</a> </td> </tr> </table> </div>

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

2. 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

3. A new draft release will created and you can add more informations about the changes, here https://github.com/USER/ClaraN/releases

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

5. 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