LemonAI Project Detailed Introduction

Project Overview

LemonAI is the world's first full-stack open-source general-purpose AI agent, capable of automating the entire process from requirement planning to result delivery. It possesses independent thinking and systematic planning capabilities, and can flexibly call various tools in a virtual environment, including writing and executing code, intelligently browsing web pages, operating Web applications, and executing commands.

Core Features

1. Complex Task Solving Ability

• Diversified Task Handling: Able to solve various complex and variable tasks, including but not limited to market research, document processing, travel planning, and data analysis.
• Systematic Decomposition: Systematically decomposes and executes complex tasks in an orderly manner through independent thinking and systematic planning.
• Tool Integration: Can flexibly call various tools in the virtual environment, such as code writing and execution, intelligent web browsing, Web application operation, etc.

2. Autonomy and Goal Orientation

• High Autonomy: Highly autonomous, able to complete tasks independently without human intervention.
• Intelligent Decision-Making: Able to perceive, reason, make decisions, and act according to preset goals.
• Dynamic Adjustment: Can dynamically adjust the execution plan according to the progress of the task.

3. Real-time Task Monitoring

• Real-time Status Viewing: Users can view the execution status of tasks in real-time through the page.
• Progress Tracking: Automatically analyzes tasks, prioritizes steps, and tracks progress in real-time.

4. Multi-Scenario Coverage

Supports complex task processing in multiple fields:

• Market Research
• Financial Analysis
• Data Analysis
• Code Programming
• Life Planning

5. Custom Mode

• Model Flexibility: In addition to the default model, it supports users to customize model access.
• Online Model Access: Supports online model access and can be used by configuring the model API.

System Requirements

Supported Operating Systems

• macOS: Requires Docker Desktop support.
• Linux: Tested on Ubuntu 22.04.
• Windows: Requires WSL and Docker Desktop support.

Hardware Requirements

• Modern processor
• Minimum 4GB RAM (recommended)

Required Software

• Docker Desktop

Installation Guide

macOS Installation

1. Install Docker Desktop

# Refer to the official documentation to install Docker Desktop

2. Configure Docker Desktop
   • Open Docker Desktop
   • Go to Settings > Advanced
   • Make sure "Allow the default Docker socket to be used" is enabled

Linux Installation

1. Install Docker Desktop
2. Ensure the system is Ubuntu 22.04 or a compatible version.

Windows Installation

1. Install WSL

# Install WSL
wsl --install
# Confirm version
wsl --version
# Make sure Default Version: 2 is displayed

2. Install Docker Desktop
3. Configure Docker Desktop
   • General: Enable "Use the WSL 2 based engine"
   • Resources > WSL Integration: Enable "Enable integration with my default WSL distro"

Quick Start

Docker Running Method

1. Pull the image

docker pull hexdolemonai/lemon-runtime-sandbox:latest

2. Run the application

docker run -it --rm --pull=always \
  --name lemon-app \
  --env DOCKER_HOST_ADDR=host.docker.internal \
  --publish 5005:5005 \
  --add-host host.docker.internal:host-gateway \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  --volume ~/.cache:/.cache \
  --volume ${WORKSPACE_BASE:-$PWD/workspace}:/app/workspace \
  --interactive \
  --tty \
  hexdolemonai/lemon:latest make run

Note: On Windows, Docker commands must be run within the WSL terminal.

Desktop Application

LemonAI provides macOS and Windows desktop applications, which can be downloaded from the official website: www.lemonai.cc

Contributing

Contact Information

• GitHub Issues: Report bugs and feature suggestions encountered during use.
• Twitter/X: @LemonAI_cc - Share applications and community exchanges.
• Commercial Licensing: service@hexdo.com - Commercial use license consultation.

Privacy and Security

To protect user privacy, please avoid posting security issues on GitHub. If you have security-related issues, please send them to service@hexdo.com.

Documentation and Support

For more detailed instructions and in-depth guidance, please refer to the official documentation: document.lemonai.cc

Project Highlights

LemonAI's uniqueness lies in the fact that it is not just a simple AI tool, but a complete intelligent agent system that can:

1. End-to-End Automation: Full process automation from task understanding to result delivery.
2. Intelligent Planning Capability: Possesses human-like task decomposition and planning capabilities.
3. Tool Ecosystem Integration: Seamlessly integrates various development and office tools.
4. Real-time Interactive Feedback: Provides transparent task execution process and real-time status updates.
5. Cross-Platform Support: Supports mainstream operating systems and deployment methods.

This makes LemonAI a truly general-purpose AI agent capable of handling various complex real-world work scenarios.