ChatKnot 🚀

A privacy-focused, high-performance React Native mobile application for chatting with AI providers and connecting MCP (Model Context Protocol) and OpenAPI tools.

🌟 Key Features

🤖 Multi-Provider & Multi-Mode Support

• Custom Endpoints: Connect any OpenAI-compatible provider (Local LLMs, OpenRouter, Anthropic, etc.).
• Smart Modes: Create specialized "Modes" (e.g., Coding, Research, Creative) each with its own system prompt, model selection, and tool configuration.
• Thinking UI: Dedicated interface for models that stream internal reasoning, featuring chunk-based rendering, shimmering animations, and a progress timer.

🛠️ Model Context Protocol (MCP) & OpenAPI

• Dynamic Tool Integration: Connect MCP servers and OpenAPI endpoints to extend AI capabilities with real-time data and tools.
• Granular Permissions: Configure "Auto-Approve" or "Manual" execution policies per tool and per mode.

📂 Multimodal input & Export

• File Support: Attach images for vision-capable models and text-based documents (PDF, Code, Markdown) for context mapping.
• Rich Exports: Save your conversations as PDF (clean markdown rendering), Markdown (with collapsible tool details), or JSON.

🔒 Security & Performance

• Encrypted Vault: All API keys and sensitive configurations are stored using hardware-backed encryption.
• Performance Optimized: Features throttled stream rendering, base64 hydration caching, and provider instance memoization for a lag-free experience.

📝 For In-Depth Info

For a complete list of version-specific changes, technical refactors, and recently shipped features, please check our Changelog.

---

🛠️ Getting Started

Installation

npm install

Run (Development)

EXPO_DEBUG=true npx expo start

⚙️ Configuration

AI Providers

In Settings -> AI Providers:

1. Add your provider's Base URL and API Key.
2. Fetch models and use the List Toggles to activate them or the Eye icon for visibility.
3. Edits are handled in Draft Mode — remember to save your changes!

MCP Servers

In Settings -> MCP Servers:

1. Add your server URL (supports OpenAPI discovery).
2. Toggles available directly in the list for quick activation.
3. Configure Tool Controls individually per mode.

📦 Build Release

To generate a production APK for Android:

npm run android:apk:release

📱 Platform Compatibility

Important

Android Primary: ChatKnot is currently only tested and fully operational on Android. Support for iOS and Web is in the experimental phase.

📄 License & Legal

• License: MIT License - see the LICENSE file for details.
• Privacy: All keys and chat data are stored locally on your device using hardware-backed encryption.

---

ChatKnot is an open-source tool for personal AI productivity. Happy Chatting! 🚀