OpenManusJava
An Intelligent Thinking System Based on Java - A Multi-modal Agent Framework with Fast/Slow Thinking
๐ Quick Start โข ๐ฏ Features โข ๐๏ธ Architecture โข
๐ Project Overview
OpenManusJava is an intelligent thinking system developed based on Spring Boot and LangChain4j. It adopts a "fast thinking/slow thinking" dual-mode architecture, combining the efficiency of direct output with the depth of a think-execute-reflect loop. The system can automatically or manually select the most appropriate thinking mode according to task complexity, significantly improving the processing quality of complex tasks.
๐ฏ Features
๐ง Multi-modal Intelligent Thinking
- Fast Thinking Mode: Direct execution for high efficiency, suitable for simple tasks.
- Slow Thinking Mode: Think-execute-reflect loop, suitable for complex tasks.
- Automatic Mode: Intelligently selects the thinking mode based on task complexity.
๐ญ Intelligent Agent System
- FastThinkWorkflow: A workflow for quick responses.
- ThinkDoReflectWorkflow: A workflow for cyclic reflection.
- Multiple Specialized Agents: Specialized agents for thinking, execution, reflection, etc.
๐ง Tool Ecosystem
- Code Execution: Executes code and analyzes the results.
- File Operations: Manages files and content.
- Web Access: Intelligently retrieves information.
๐จ User Interface
- Modern 3-Column Workspace:
- Left: An intelligent chat panel for core human-computer interaction.
- Middle: A versatile tool panel displaying structured search results, tool outputs, and files.
- Right: A browser workspace with multi-tab support, address bar navigation, and dual-mode (Web/VNC) capabilities.
- Real-time Thinking Process: Visualizes the AI's thinking steps and logs.
- Responsive Design: Adapts to desktop, tablet, and mobile devices.
๐ผ๏ธ UI Preview
Note: Some websites block being embedded in an iframe via security headers like
X-Frame-Optionsor CSPframe-ancestors. If you see โๆญค็ฝ็ซๆ ๆณๅจๆญค้ข่งโ, enable the โไปฃ็โ toggle in the address bar to load the page through the backend proxy.
๐๏ธ Architecture
Core Architecture Diagram
graph TD
User --> UI[Web Interface]
UI --> Controller[AgentController]
Controller --> Service[AgentService]
subgraph "Workflow"
Service -->|Complex Task| TDR[ThinkDoReflectWorkflow<br/>Deep Thinking]
Service -->|Simple Task| FT[FastThinkWorkflow<br/>Quick Response]
end
TDR --> TA[ThinkingAgent<br/>Analyze & Plan]
TA --> EA[ExecutionAgent<br/>Execute Task]
EA --> RA[ReflectionAgent<br/>Evaluate Result]
RA -->|Task Complete| FinalResult[Final Result]
RA -->|Needs More Work| TA
subgraph "Tool Layer"
CodeTool[Code Execution Tool]
FileTool[File Operation Tool]
SearchTool[Information Retrieval Tool]
end
EA --> CodeTool
EA --> FileTool
EA --> SearchTool
FT --> FinalResult
FinalResult --> WebSocket --> UI
Technology Stack
| Component | Technology | Purpose |
|---|---|---|
| Backend Framework | Spring Boot 3.2.0 | Core application framework |
| AI Integration | LangChain4j 1.1.0 | LLM integration and multi-agent collaboration |
| Frontend | Vue.js 3 + Element Plus | Modern, responsive user interface |
| Real-time Comms | WebSocket + STOMP | Real-time messaging and log streaming |
| API | RESTful API | Service interface |
| Documentation | Markdown | Project documentation |
๐ Quick Start
Prerequisites
- Java 21+
- Maven 3.9+
- Alibaba Cloud Bailian API Key (or other supported LLM service)
Installation
-
Clone the project
git clone https://github.com/OpenManus/OpenManus-Java.git cd OpenManus-Java -
Configure API keys (recommended) Copy
dotenv.exampleto.envand fill in your API keys: -
Optional: override application config Use
src/main/resources/application-example.ymlas a reference, and createsrc/main/resources/application-local.ymlfor personal overrides. -
Start the application
If you created
application-local.yml, run with the local profile:mvn spring-boot:run -Dspring-boot.run.profiles=local
-
Access the service Open your browser and go to: http://localhost:8089
For a one-command setup (Docker Compose), see: docs/QUICK_START.md.
๐ Usage
Unified API Endpoint
All interactions are handled through a unified streaming API, think-do-reflect-stream, which automatically processes and returns real-time progress.
# Example Request curl -X POST http://localhost:8089/api/agent/think-do-reflect-stream \ -H "Content-Type: application/json" \ -d '{"input": "Analyze the development trend of the tourism industry during the Spring Festival."}'
API Documentation
Swagger UI: http://localhost:8089/swagger-ui.html
๐ฌ Contact Me
- WeChat: leochame007
- Email: liulch.cn@gmail.com
๐ Acknowledgements
Thanks to the following open-source projects for their support:
๐ License
This project is licensed under the MIT License.
๐ If this project is helpful to you, please give it a Star!


