🚀 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 management

 Tool Integration and Calling

• Dynamic discovery and loading of MCP servers

• Tool configuration management support

• Exception handling and timeout control

• Standardized tool calling interface

Supported 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

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

git clone https://github.com/isoftstone-data-intelligence-ai/efflux-desktop.git
cd efflux-desktop

2. Install Dependencies

Install dependencies using uv package manager:

pip install uv
uv sync --reinstall

3. Activate virtual environment

Activate a virtual environment and configure environment variables.

# Activate virtual environment
source .venv/bin/activate   # MacOS/Linux

# Deactivate when needed
deactivate

4. Start the Service

uv run

The service will start at http://127.0.0.1:8000.

API Usage Examples

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