Skip to content

A high-determinism, code-free 'Prompt Programing' framework built with Java 一个高确定性的 无代码 'Prompt编程'框架,以 Java 编写

License

Notifications You must be signed in to change notification settings

leon-king/JManus

 
 

Repository files navigation

Spring AI Alibaba JManus

image


✨ About JManus

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.

🎯 JManus Product Features

🤖 Pure Java Manus Implementation:

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

🛠️ Func-Agent Mode:

Allows you to precisely control every execution detail, providing extremely high execution determinism and completing complex repetitive processes and functions. For specific examples, see JManus Use Cases - FuncAgent Use Case

Image

🔗 MCP Integration:

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

Image

🚀 Quick Start

Get JManus up and running in under 5 minutes:

Prerequisites

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

Method 1: Using GitHub Release (Recommended)

📦 Download and Run JAR File

# 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.

🌐 Access Application

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. You can visit https://github.com/talk-flow/public-usecase to explore some effective practices we recommend.


Method 2: Running from Source Code (Alternative)

1. Clone and Navigate

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

2. Database Configuration (Optional)

💡 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.

3. Launch the Application

For Unix-like systems (macOS, Linux):

../mvnw spring-boot:run

For Windows systems:

../mvnw.cmd spring-boot:run

4. Access Your Multi-Agent Dashboard

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

🎉 Congratulations! Your multi-agent system is now live and ready for action. You can visit https://github.com/talk-flow/public-usecase to explore some effective practices we recommend.

Stable Release

you can find stable release from here: release

🤝 Contributing

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

Contribution Opportunities

You can find available tasks on our project board.

Development Environment Setup

# Fork and clone the repository
git clone git@github.com:spring-ai-alibaba/JManus.git
cd JManus

# Install project dependencies
mvn clean install

# Apply code formatting standards
mvn spotless:apply

# Start the development server
mvn spring-boot:run

Development Guidelines

  • 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

交流讨论

点击这个链接加入钉钉群讨论:钉群链接

Crafted with ❤️ by the Spring AI Alibaba Team

Star us on GitHub if JManus accelerated your development journey!

About

A high-determinism, code-free 'Prompt Programing' framework built with Java 一个高确定性的 无代码 'Prompt编程'框架,以 Java 编写

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 63.2%
  • Vue 22.5%
  • TypeScript 8.8%
  • JavaScript 4.2%
  • Shell 0.3%
  • Python 0.3%
  • Other 0.7%