Sathi is a Generative AI client plugin designed particularly for Dank Material Shell. It enables you to interact with Large Language Models (LLMs) directly from your desktop shell making it easy to ask questions, find commands without needing to switch apps or open a browser.
sathi-ai-demo.mp4
- 💬 Desktop Chat Interface: Talk to AI without opening a browser.
- ⚡ Multi-Provider Support: Supports Google Gemini, OpenAI, Anthropic, Ollama, LMStudio models.
- 🎨 Markdown Support: Chat bubbles support markdown formatting, clickable links and copying to clipboard.
- 🎭 Context Control: Allows you to set and specify context details for how you want the AI to behave.
- 🛠️ Configurable: Set your API keys and endpoints directly in settings.
- 📌 Pin to Top: Keep the chat visible while you work. You can still use other apps underneath it.
- 🚀 Instant-ish Open: Speedy window access to make it faster to access your conversations.
- Limited context to the last x,y messages that can be set. (Running a dameon or service or even a process could work around this but complicates install and use.)
- When listing models right now we get all available models offered by a service - many of which may not be useful. Users will need some idea of the model they want to use.
- Sessions are cleared when logging out and not saved.
- Install the plugin to your plugins directory (
~/.config/DankMaterialShell/plugins) by default. - Enable the plugin in the plugins screen.
- Add the widget to your widgets tab.
- (Optional) - add a shortcut key to open the plugin ie in niri/config.kdl you can add something like:
Mod+Shift+Space { spawn-sh "dms ipc call widget toggle sathiAi"; }
- Enable the plugin in Dank Settings.
- Open the Sathi settings page.
- Configure your AI providers:
- Google Gemini: Enter your API Key from Google AI Studio.
- OpenAI: Enter your API Key from OpenAI Platform.
- Anthropic: Enter your API Key from Claude Platform.
- Ollama: Enter your local server URL (default:
http://localhost:11434). - LMStudio: Enter your local LMStudio server URL (default:
http://localhost:1234). Uses the OpenAI API format.
- (Optional) Set a custom System Prompt to define the AI's persona.
- Click the Sathi widget in your shelf/panel.
- Select your preferred model from the dropdown (Gemini models and local Ollama models will appear mixed).
- Type your message and press Enter!
- "Script failed" or missing responses:
- Ensure your API Key is correct.
- Check the
dmslogs (DMS_LOG_LEVEL=debug dms run) for more details.
- Dank Matter Shell is dope as hell. Actually made me like my desktop.
- Niri is amazing it made me want to use my laptop.
- I find Ai convenient but all the ai clients i tried just didn't fit with my new found niri flow.
- DMS plugin system was easy to work with and i wanted to learn and try something.
- While I take pride in writing a chunk of the code by hand and resolving logic that the AI just couldn't get right, I also used AI to do a bunch of tedious, monotonous tasks, which in my opinion is the perfect use of it.
