JManus is a Java implementation of Manus, currently used in many applications within Alibaba Group. It is primarily used for handling exploratory tasks that require a certain degree of determinism, such as quickly finding data from massive datasets and converting it into a single row in a database, or analyzing logs and issuing alerts.

JManus also provides HTTP service invocation capabilities, making it suitable for integration into existing projects. For details, please refer to the developer quick start guide.

A pure Java multi-agent collaboration implementation that provides a complete set of HTTP call interfaces, suitable for secondary integration by Java developers.

Allows you to precisely control every execution detail, providing extremely high execution determinism.

Natively supports the Model Context Protocol (MCP) for seamless integration with external services and tools.

Easily configure agents through an intuitive web management interface without modifying code.

Supports precise extraction of target information from massive content without relying on specific long-context models.

Get JManus up and running in under 5 minutes:

• 🌐 DashScope API Key (or alternative AI model provider)
• ☕ Java 17+ (for running JAR files or source code execution)

# Download the latest JAR file
wget https://github.com/spring-ai-alibaba/JManus/releases/latest/download/jmanus.jar

# Or using curl
curl -L -o jmanus.jar https://github.com/spring-ai-alibaba/JManus/releases/latest/download/jmanus.jar

# Run the JAR file
java -jar jmanus.jar

💡 Manual Download: You can also visit the JManus Releases page to manually download the latest JAR file.

After the application starts, navigate to http://localhost:18080 in your browser.

💡 Guided Setup: After the application starts, it will automatically display a guided setup page. On the first page, select your language (English/Chinese), then on the second page, enter your DashScope API key that you just obtained to complete the configuration.

🎉 Congratulations! Your multi-agent system has been quickly started.

git clone https://github.com/spring-ai-alibaba/JManus.git
cd JManus

💡 Get your DashScope API Key: Visit Alibaba Cloud Console to obtain your free API key.

Using other providers? Update the configuration in src/main/resources/application.yml to use your preferred AI model platform.

JManus supports both H2 (default)、MySQL and PostgreSQL databases.

How To Use MySQL/PostgreSQL

1. Configure Database Connection: Update the database configuration and JPA database-platform in the application-mysql.yml/application-postgres.yml under 'src/main/resources/':

   spring:
     datasource:
       url: your_url
       username: your_username
       password: your_password
     jpa:
       database-platform: org.hibernate.dialect.MySQLDialect/PostgreSQLDialect

2. Activate MySQL/PostgreSQL Profile: Update configuration in src/main/resources/application.yml:

   spring:
     ...
     profiles:
       active: mysql/postgres  

💡 Note: The application will automatically create required tables on first startup using JPA's ddl-auto: update configuration.

For Unix-like systems (macOS, Linux):

../mvnw spring-boot:run

For Windows systems:

../mvnw.cmd spring-boot:run

Navigate to http://localhost:18080 in your browser.

🎉 Congratulations! Your multi-agent system is now live and ready for action.

💡 AI Application Security: As with any AI-powered application in production environments, we recommend implementing appropriate authentication and access controls. For JManus specifically, this includes securing access to model chat interfaces, MCP service configuration, built-in tool management, and system parameter adjustment features to prevent misuse and unauthorized access.

you can find stable release from here: release

We enthusiastically welcome contributions from the developer community! Here's how you can make an impact:

You can find available tasks on our project board.

• 🐛 Bug Reports: Submit detailed issue reports
• 💡 Feature Requests: Propose innovative enhancements
• 📝 Documentation: Help us improve clarity and completeness
• 🔧 Code Contributions: Submit pull requests with your improvements

# Fork and clone the repository
git clone https://github.com/your-username/spring-ai-alibaba.git
cd spring-ai-alibaba/spring-ai-alibaba-jmanus

# Install project dependencies
mvn clean install

# Apply code formatting standards
mvn spotless:apply

# Start the development server
mvn spring-boot:run

• Follow existing code style and conventions
• Write comprehensive tests for new features
• Update documentation for any API changes
• Ensure all tests pass before submitting PRs