EFFLUX.AI
- desktop-chat
Open-Source General-Purpose AI Agent Platform**
About
What is EFFLUX.AI?
Efflux Desktop is an AI copilot for individuals that integrates multi-vendor LLM models and tool invocation via the Model Context Protocol (MCP). It runs on Windows and macOS, giving users control over their human-AI collaboration.
How to use EFFLUX.AI?
After installing the executable, launch Efflux, go to the Models page to configure a vendor API key and endpoint. Then visit the Plugins page to add custom MCP servers (via command/arguments or JSON). Finally, start a chat, select your model, and use the @ sign to invoke a plugin.
Key features of EFFLUX.AI
- Multi-vendor AI model integration (OpenAI, Anthropic, DeepSeek, etc.)
- Dynamic discovery and loading of MCP servers
- Standardized tool calling with exception handling and timeout control
- Text-to-artifact capabilities and real-time streaming responses
- Chat history management and Build mode for constructing tasks
- Plugin management with custom command or JSON configuration
Use cases of EFFLUX.AI
—
FAQ from EFFLUX.AI
What platforms does EFFLUX.AI support?
Windows and macOS.
How do I add my own MCP server?
In the Plugins page, click “Add Custom Plugin” and enter the plugin name, command, environment variables, and arguments, or switch to JSON Mode and paste a JSON string.
Is EFFLUX.AI free and open source?
Yes, the project follows an appropriate open source license. Refer to the LICENSE file for details.
Which AI models are supported?
Multiple vendors are supported, including OpenAI, Anthropic, DeepSeek, and others.
How do I configure a model?
Go to the Models page, find your vendor card, click “API-KEY”, and enter your endpoint and API key, then click Save.
Details
- Author
- isoftstone-data-intelligence-ai
- Category
- desktop-chat
- Repository
- isoftstone-data-intelligence-ai/efflux-desktop
🚀 Project Overview
Efflux — An AI Copilot built for super-individuals. Efflux Desktop integrates multi-vendor models and tool invocation capabilities, supporting command-based tool access and plugin extensions. Designed for real-world tasks, Efflux brings human-AI collaboration back under your control — amplifying the judgment and execution power of super-individuals. It doesn’t decide for you — it helps you stay in control.✨ Core Features
LLM-powered Conversations
Multi-vendor AI model integration (OpenAI, Anthropic, DeepSeek, etc.) Natural-language-based conversations Text-to-artifact capabilities Real-time streaming chat responses Chat history managementTool Integration and Calling
Dynamic discovery and loading of MCP servers Tool configuration management support Exception handling and timeout control Standardized tool calling interfaceSupported OS
Windows macOS🚀 Quick Start
After installing the executable file and launching Efflux Desktop, you can start your AI journey by following the following steps.Configure Your Models
1. In the navigation pane of Efflux Desktop, select Models. 2. In the Model Providers page, find your desired vendor card, and click API-KEY. 3. In the pop-up dialog, enter your endpoint and API key, and click Save.Install Plugins
If you want to use existing MCP servers to complete your task, do the following: 1. In the navigation pane, select Plugins. 2. In the Discover Plugins tab, click Add Custom Plugin. 3. In the pop-up dialog, do either of the following and click Add. 1. enter the plugin name, command, environment variables, and arguments (if any), or 2. if you've already got a JSON string, select JSON Mode and paste it. Tip Leverage the following resources of MCP server to unlock more automation capabilities. https://mcp.so/ https://mcpmarket.cn/ https://mcp-servers-hub-website.pages.dev/Start Your Conversation
1. In the navigation pane, select Chat. 2. In the chatbox, select the model you've configured, and: 1. tell Efflux your question, or 2. switch to the Build mode and describe what you want Efflux to build. 3. To use the installed plugin, enter the @ sign and select the target one. 4. Press the Enter key to start your conversation.🏗️ Project Architecture
Directory Structure
``plaintext
efflux-desktop/
├── adapter/ # Adapter layer
│ ├── mcp/ # MCP protocol adapters
│ ├── model_sdk/ # Model SDK adapters
│ ├── persistent/ # Persistence adapters
│ └── web/ # Web interface adapters
├── application/ # Application layer
│ ├── domain/ # Domain objects
│ ├── port/ # Port interfaces
│ └── service/ # Application services
├── common/ # Common components
│ ├── core/ # Core infrastructure
│ └── utils/ # Utility classes
└── main.py # Application entry point
`
🔧 Development Guide
1. Clone the Project
`bash
git clone https://github.com/isoftstone-data-intelligence-ai/efflux-desktop.git
cd efflux-desktop
`
2. Install Dependencies
Install dependencies using uv package manager:
`bash
pip install uv
uv sync --reinstall
`
3. Activate virtual environment
Activate a virtual environment and configure environment variables.
`shell
Activate virtual environment
source .venv/bin/activate # MacOS/Linux
Deactivate when needed
deactivate
`
4. Start the Service
`bash
uv run
`
The service will start at http://127.0.0.1:8000.
API Usage Examples
`bash
POST /api/agent/chat/default_chat
Content-Type: application/json
{
"firm": "openai",
"model": "gpt-4",
"system": "You are a helpful AI assistant",
"query": "Hello, please introduce yourself",
"mcp_name_list": ["example-server"]
}
`
🤝 Contributing
1. Fork this project.
2. Create a feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature`).
5. Submit a Pull Request.
📄 License
This project follows the appropriate open source license. Please refer to the LICENSE file for details.🆘 Support & Help
For questions or suggestions, please contact us through: Submit Issues- Start Discussions
