# JManus
**Repository Path**: ym2j/JManus
## Basic Information
- **Project Name**: JManus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-12-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Spring AI Alibaba Lynxe
[](LICENSE)
[](https://openjdk.java.net/)
[](https://spring.io/projects/spring-boot)
[](https://github.com/alibaba/spring-ai-alibaba/stargazers)
๐ [English](./README.md) | [ไธญๆ](./README-zh.md)
[About](#-about) โข [Quick Start](#-quick-start) โข [Contributing](#-contributing)
[Use Cases](https://github.com/Lynxe-public/Lynxe-public-prompts)
---
## โจ About Lynxe(Original name: JManus๏ผ
Lynxe 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.
You can find some recommended Func-Agent implementations we've prepared at [Use Cases](https://github.com/Lynxe-public/Lynxe-public-prompts).
Lynxe also provides HTTP service invocation capabilities, making it suitable for integration into existing projects. For details, please refer to the [developer quick start guide](./README-dev-en.md).
## ๐ฏ Lynxe 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 [Lynxe Use Cases - FuncAgent Use Case](https://github.com/Lynxe-public/Lynxe-public-prompts/blob/main/eng/query-plan.md)
### ๐ **MCP Integration**:
Natively supports the Model Context Protocol (MCP) for seamless integration with external services and tools.
## ๐ Quick Start
Get Lynxe 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) or ๐ณ **Docker** (for containerized deployment)
### Method 1: Using GitHub Release (Recommended)
#### ๐ฆ Download and Run JAR File
```bash
# Download the latest JAR file
wget https://github.com/spring-ai-alibaba/Lynxe/releases/latest/download/lynxe.jar
# Or using curl
curl -L -o lynxe.jar https://github.com/spring-ai-alibaba/Lynxe/releases/latest/download/lynxe.jar
# Run the JAR file
java -jar lynxe.jar
```
> ๐ก **Manual Download**: You can also visit the [Lynxe Releases page](https://github.com/spring-ai-alibaba/Lynxe/releases) 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: Using Docker (Recommended for Production)
#### ๐ณ Pull and Run Docker Image
```bash
# Pull the latest Lynxe Docker image
docker pull ghcr.io/spring-ai-alibaba/lynxe:v4.7.0
# Run the container
docker run -d \
--name lynxe \
-p 18080:18080 \
ghcr.io/spring-ai-alibaba/lynxe:v4.7.0
```
#### ๐ง Advanced Docker Configuration
**Run with data persistence (recommended for production):**
```bash
# Create a directory for data persistence
mkdir -p ./lynxe-data
# Run with volume mounting
docker run -d \
--name lynxe \
-p 18080:18080 \
-v $(pwd)/lynxe-data:/app/data \
ghcr.io/spring-ai-alibaba/lynxe:v4.7.0
```
**Run with custom environment variables:**
```bash
docker run -d \
--name lynxe \
-p 18080:18080 \
-e SPRING_PROFILES_ACTIVE=mysql \
-e SPRING_DATASOURCE_URL=jdbc:mysql://host.docker.internal:3306/lynxe \
-e SPRING_DATASOURCE_USERNAME=your_username \
-e SPRING_DATASOURCE_PASSWORD=your_password \
ghcr.io/spring-ai-alibaba/lynxe:v4.7.0
```
#### ๐ Access Application
After the container 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.
#### ๐ Useful Docker Commands
```bash
# View container logs
docker logs -f lynxe
# Stop the container
docker stop lynxe
# Start the container
docker start lynxe
# Remove the container
docker rm lynxe
```
๐ **Congratulations!** Your multi-agent system is now running in Docker. You can visit https://github.com/talk-flow/public-usecase to explore some effective practices we recommend.
---
### Method 3: Running from Source Code (Alternative)
#### 1. Clone and Navigate
```bash
git clone https://github.com/spring-ai-alibaba/Lynxe.git
cd Lynxe
```
#### 2. Database Configuration (Optional)
> ๐ก **Get your DashScope API Key**: Visit [Alibaba Cloud Console](https://bailian.console.aliyun.com/?tab=model#/api-key) 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.
Lynxe 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/':
```yaml
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`:
```yaml
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):**
```bash
../mvnw spring-boot:run
```
**For Windows systems:**
```bash
../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/Lynxe-public/Lynxe-public-prompts to explore some effective practices we recommend.
## Stable Release
you can find stable release from here:
[release](https://github.com/spring-ai-alibaba/Lynxe/releases)
## ๐ค 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](https://github.com/orgs/spring-ai-alibaba/projects/1).
- ๐ **Bug Reports**: [Submit detailed issue reports](https://github.com/spring-ai-alibaba/Lynxe/issues)
- ๐ก **Feature Requests**: [Propose innovative enhancements](https://github.com/spring-ai-alibaba/Lynxe/issues)
- ๐ **Documentation**: Help us improve clarity and completeness
- ๐ง **Code Contributions**: [Submit pull requests](https://github.com/spring-ai-alibaba/Lynxe/pulls) with your improvements
### Development Environment Setup
```bash
# Fork and clone the repository
git clone git@github.com:spring-ai-alibaba/Lynxe.git
cd Lynxe
# 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
---
## ไบคๆต่ฎจ่ฎบ
็นๅป่ฟไธช้พๆฅๅ ๅ
ฅ้้็พค่ฎจ่ฎบ๏ผ[้็พค้พๆฅ](https://qr.dingtalk.com/action/joingroup?code=v1,k1,PBuFX00snERuKcnnG4YAPK52FOXwAkLYlulUUD9KiRo=&_dt_no_comment=1&origin=11)
**Crafted with โค๏ธ by the Spring AI Alibaba Team**
โญ **Star us on GitHub** if Lynxe accelerated your development journey!
๐ Developer Docs: [Quick Start (EN)](./README-dev-en.md) | [ๅผๅ่
ๅฟซ้ๅ
ฅ้จ (ไธญๆ)](./README-dev.md)