Sorana
Tetramatrix/Sorana
Personal AI Knowledge Workspacee
Instalação
npx convez-ai Tetramatrix/Sorana1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
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
- Download the portable archive from tetramatrix.github.io/Sorana
- Extract anywhere, desktop, USB, external drive
- Run
Sorana.exe, no installation needed - Open a folder as your workspace via Open Workspace
- Select an AI model in Model Manager (built-in offline model included)
Latest: Sorana.exe v1.0.58
📥 [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
- Open MCP Manager and enable the servers you need
- Create an agent in your workspace
- Right-click the agent title → Chat
- 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