Skip to content

Tetramatrix/Sorana

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

289 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Sorana, Your Personal AI That Actually Knows You

A second brain that remembers, organises, and acts. Built for knowledge workers who are tired of starting from zero every day.


What is Sorana?

Most AI tools forget you the moment you close the window. Sorana doesn't.

Sorana is a personal AI knowledge workspace for Windows. It builds a lasting memory of your projects, files, and thinking style, so every time you open it, your AI already knows where you left off. Think of it as Obsidian's spatial canvas combined with an AI assistant that has actually read your notes, remembers your preferences, and can take action on your behalf.

No subscriptions. No cloud required. Everything runs on your machine.


Who Is Sorana For?

  • πŸ“š Researchers & academics, chat with hundreds of papers, books, and scanned notes in one unified workspace
  • ✍️ Writers & journalists, build a living reference library that remembers your style, sources, and ideas
  • πŸ§‘β€πŸ’Ό Consultants & freelancers, maintain full AI context across multiple long-running client projects
  • πŸŽ“ Students, turn notes, PDFs, and lecture slides into a personal knowledge base you can actually talk to
  • 🧠 Obsidian & Notion users, add an AI layer that learns from your vault and can act on it
  • πŸ”’ Privacy-conscious professionals, full AI power, zero data leaving your machine

The Problems Sorana Solves

🧠 You're tired of re-explaining yourself every day

Every AI chat starts from zero. You paste background context, re-explain your project, re-state your preferences, again and again. Sorana quietly learns from every conversation and greets you with full context next time you open it. No setup. No copy-pasting. Just continuity.

πŸ“‚ Your knowledge is scattered and hard to find

Notes in Obsidian, files in folders, research in browser tabs. You spend more time searching than actually thinking. Sorana maps your files onto a 2D spatial canvas by topic and relationship, find anything by what it's about, not where it's saved.

πŸ”Œ Your AI advises, but can't do anything

Sorana's AI doesn't just answer questions, it acts. Organise files, summarise documents, fetch web content, manage emails, all through plain-language conversation. No app switching, no copy-pasting.

πŸ‘οΈ Half your knowledge is locked in PDFs and images

Scanned book pages, photographed receipts, PDF reports, dead to most AI tools. Sorana's built-in OCR and vision layer makes your entire archive searchable and chattable, including documents from years ago.

πŸ’Έ Long conversations get slow and expensive

The longer a project runs, the heavier the AI context grows. Sorana automatically compresses old conversations into tight summaries, over 90% fewer tokens, full context preserved. Long-term projects stay fast and affordable.

πŸ”’ Your private files shouldn't live on someone else's server

Every file you send to ChatGPT or Claude leaves your machine. Sorana runs AI models entirely on your computer. Your notes, files, and conversations never leave your hands.


Key Features

🧩 Spatial Knowledge Canvas

AI maps your files onto a 2D canvas by topic and relationship, not alphabetically, not by date, but by meaning. Like Obsidian Canvas, but automatically organised by your AI. Drag, group, rename, and build mind maps of your folder structure.

🧠 Persistent AI Memory

Sorana automatically extracts facts, preferences, and project details from every conversation. Next session, your AI knows your name, your current projects, and how you like to work. Memory is shared across all your agents, building a single unified knowledge profile over time.

πŸ’¬ Chat With All Your Documents

Drop any file, PDF, Word doc, code, text, scanned image, into your workspace and chat with it in plain language. Sorana searches your documents using multiple strategies in parallel to always find the right answer, even in large archives.

⚑ Auto-Compaction (>90% Token Savings)

Long conversations are automatically compressed into tight summaries. You keep 100% of the context at a fraction of the cost. Projects that span months stay fast and affordable.

πŸ€– AI That Takes Action

Beyond answering questions, Sorana's built-in automation layer lets your AI operate your file system, browse the web, and manage your Gmail, all through natural conversation. Tell it what you need done; it handles the rest.

πŸš€ Obsidian Export

Already using Obsidian? Export your Sorana workspace directly to Obsidian Canvas or Graph View. Your AI-organised knowledge structure, carried into your existing vault. Use Sorana for AI-powered work; keep Obsidian as your permanent archive.

πŸ”’ 100% Local & Private

Run AI models entirely on your machine via Lemonade, Ollama, Llama.cpp, or LM Studio. Your files never leave your computer. Cloud APIs (OpenAI, Mistral, Gemini, etc.) are supported if you choose them, but never required.

πŸ“¦ Truly Portable

No installation. Unzip anywhere, run from a USB drive, take your entire workspace with you. All data stored in a single .sorana/ folder you own completely.


How Sorana Compares

What you get Sorana ✨ Obsidian / Notion ChatGPT / Claude OpenWebUI
AI remembers you between sessions βœ… Automatic ❌ Manual notes only ⚠️ Limited / paid ❌ None
Visual knowledge canvas βœ… AI-organised βœ… Manual (Obsidian) ❌ Chat only ❌ Chat only
Chat with your documents βœ… Any file, any format ⚠️ Plugin required ⚠️ Per session upload ⚠️ Basic
AI takes action on files & web βœ… Built-in automation ❌ View only ❌ Advice only ⚠️ Community tools
Runs 100% offline & private βœ… Your machine βœ… Notes are local ❌ Cloud only βœ… Local
Stays fast over months of use βœ… Auto-compaction βœ… (no AI context) ⚠️ Gets slow & costly ❌ Manual
Free to use βœ… Free & portable ⚠️ Free + paid tiers ❌ $20+/month βœ… Free

Sorana combines what Obsidian/Notion do for knowledge organisation with what AI assistants do for conversation, plus the automation that neither offers.


Quick Start

  1. Download the portable archive from tetramatrix.github.io/Sorana
  2. Extract anywhere, desktop, USB, external drive
  3. Run Sorana.exe, no installation needed
  4. Open a folder as your workspace via Open Workspace
  5. Select an AI model in Model Manager (built-in offline model included)

Latest: Sorana.exe v1.0.53 πŸ“₯ [Download (Portable)](tetramatrix.github.io/Sorana](http://tetramatrix.github.io/Sorana) πŸͺ Microsoft Store


System Requirements

Component Minimum
OS Windows 11 (64-bit)
RAM 4 GB (8 GB+ recommended for local AI models)
Storage 2 GB (app + model) + .sorana/ data folder
AI Built-in offline model included; local or cloud AI optional

AI Model Options

  • Built-in model (~806 MB), works fully offline out of the box
  • Recommended, Llama 3.1 8B Instruct or higher for best results (requires 8 GB RAM / 4 GB VRAM)
  • Cloud, OpenAI, Mistral, Gemini, Deepseek, NVIDIA, OpenRouter (free tiers available), no local hardware required
  • Local servers, πŸ‹ Lemonade (NPU acceleration), Ollama, LM Studio, Llama.cpp

πŸŽ‰ Free tier APIs available, Deepseek, Mistral, NVIDIA, Gemini, and OpenRouter all offer free tiers. Just add your API key.


Obsidian Integration

Sorana connects directly to your Obsidian vault:

  • Export to Canvas, bring your AI-organised workspace layout into Obsidian's infinite Canvas
  • Export to Graph View, generate a knowledge graph from your workspace structure, compatible with Obsidian's Graph View
  • Full compatibility with Dataview, Templater, Excalidraw, and all other Obsidian plugins
  • Standard Markdown files, no lock-in, your data stays yours

Using MCP Automation

  1. Open MCP Manager and enable the servers you need
  2. Create an agent in your workspace
  3. Right-click the agent title β†’ Chat
  4. Give instructions in plain language, files, web, email, all accessible

Connect external services: Google Drive, GitHub, PostgreSQL, custom tools.


OCR for Scanned Documents

To enable OCR on PDFs with embedded images, install Tesseract OCR and ensure it's in your system PATH. Once installed, Sorana processes scanned documents automatically, making your entire paper archive searchable.


Links

🌐 Website: tetramatrix.github.io/Sorana πŸ’¬ Discord: discord.gg/4QkQSfSATF πŸͺ Microsoft Store: apps.microsoft.com


Other Tools by Tetramatrix

  • 🧩 TabNeuron, AI spatial tab manager & browser research workspace
  • πŸ–₯️ Aicono, AI intelligent desktop icon organiser
  • πŸ”§ RyzenZPilot, AMD Ryzen power management tool
  • πŸš€ Spaceship!, Retro 2D arcade game

🏒 Developed by Tetramatrix | 🧠 Your personal AI knowledge workspace | πŸ’ Free for everyone