Tip

Pinac Workspace is build on our custom Python library "Kitkat: A modern & minimal Python library for talking to LLMs."

Our library is currently under active development. For knowing more, visit our library's official website and if you want to contribute, visite our repository RajeshTechForge/kitkat.

Privacy-first, cross-platform desktop AI assistant for everyone

---

What is Pinac-Workspace ?

Pinac-Workspace is a minimalist-designed & lightweight secure desktop AI-chat experience built with Tauri & React and powered by python FastAPI backend. It is designed for people who want flexibility, speed, security and control over their data _with minimum load on RAM.

🔥 Features

• Model Freedom: Bring your own API key and connect any supported model — including those with extended thinking mode. No vendor lock-in, no forced defaults.

• Security-oriented Architecture: Built desktop-first, not as a browser-based shell. The reduced attack surface means your keys and conversation data stay where they belong: on your machine.

• Local Chat History: Every conversation is persisted locally via SQLite. Pick up where you left off without relying on any cloud sync or external service.

• FastAPI Backend: The Python backend is thin, fast, and easy to extend. Swap components, add endpoints, or hook into your own tooling without fighting the architecture.

• Lightweight by Design: Low RAM footprint with minimal resource usage — runs comfortably alongside the rest of your development environment without competing for headroom.

• Cross-platform Consistency: A native feel across major desktop platforms with no platform-specific workarounds required.

• Minimalist Interface: No dashboards, no telemetry nags, no clutter. Just a focused UI that stays out of your way.

🚀 Getting Started

There are two ways to setup depending on your focus:

• Frontend only — No Rust or Python required. Launch the mock UI in a browser and work entirely on the desktop app's interface. Made for testing UI changes without needing to run the full desktop app.
• Full setup — Required if you are working on the backend, core desktop functionality, or want to run the full app locally.

Prerequisites

Requirement	Purpose
Node.js	Desktop app and mock UI
Python + uv	Backend and package management (full setup only)
Rust	Tauri desktop builds (full setup only)

1. Clone the Repository

git clone https://github.com/RajeshTechForge/pinac_workspace.git
cd pinac_workspace

2. Install Dependencies

# Desktop app dependencies
cd desktop
npm install

# Python backend dependencies
uv sync
uv pip install -e .   # Install in editable mode

3. Launch the App

The backend and desktop app run as separate processes. Open two terminal panels:

Terminal 1 — FastAPI backend:

cd backend
uv run uvicorn nexus.api.app:app --reload

Terminal 2 — Desktop app:

# Full desktop app
npm run tauri dev

# Mock UI in browser (no Rust or Python needed)
npm run dev:mock

⌛ Finding old versions ?

Checkout build/electron branch for the old Electron-based version of Pinac-Workspace. This branch contains the previous implementation before we switched to Tauri for better performance and security. Also you can find in release section of this repository for the old releases.

🤝 Contributing

Contributions are always welcome, whether you are fixing bugs, improving UX, or proposing new features.

Please read the Contributing Guidelines to get started.

📝 License

Distributed under the MIT License. See LICENSE for details.

---

Built with ❤️ for a better AI future by @RajeshTechForge