Lemon provides macOS and Windows desktop applications, available for download on our official website: www.lemonai.cc.

Get to know Lemon AI quickly · Docker Quick Deployment · Documentation ·

Lemon is an open-source General AI Agent capable of automating the entire process from requirement planning to result delivery. It can independently think and systematically plan, flexibly invoking various tools in a virtual environment, such as writing and executing code, intelligently browsing the web, operating web applications, and executing commands. Lemon excels at systematically breaking down complex tasks and executing them in an orderly manner, automatically analyzing tasks, prioritizing steps, dynamically adjusting plans, and tracking progress in real time. Its goal is to help users efficiently complete all kinds of tasks.

Lemon is capable of solving a wide range of complex and dynamic tasks, including but not limited to market research, document processing, travel planning, and data analysis. Through independent thinking and systematic planning, it can flexibly utilize various tools in the virtual environment—such as writing and executing code, intelligently browsing web pages, and operating web applications.

Lemon possesses a high degree of autonomy and can complete tasks independently without human intervention. It is able to perceive, reason, make decisions, and act based on predefined objectives.

Users can monitor the execution status of tasks in real time through the page sidebar.

Lemon is designed to handle complex tasks across multiple domains, including market research, financial analysis, data analysis, code programming, life planning, and more.

In addition to the default model, Lemon supports user-defined model integration and online model access. These models can be used by configuring the model API.

• Quickly get Lemon running in your environment with this starter guide. Use our documentation for further references and more in-depth instructions.

• MacOS with Docker Desktop support
• Linux
• Windows with WSL and Docker Desktop support

A system with a modern processor and a minimum of 4GB RAM is recommended to run Lemon.

Docker Desktop

1. Install Docker Desktop on Mac.
2. Open Docker Desktop, go to Settings > Advanced and ensure Allow the default Docker socket to be used is enabled.

Tested with Ubuntu 22.04.

Docker Desktop

1. Install Docker Desktop on Linux.

WSL

1. Install WSL.
2. Run wsl --version in powershell and confirm Default Version: 2.

Docker Desktop

1. Install Docker Desktop on Windows.
2. Open Docker Desktop, go to Settings and confirm the following:

• General: Use the WSL 2 based engine is enabled.
• Resources > WSL Integration: Enable integration with my default WSL distro is enabled.

note

The docker command below to start the app must be run inside the WSL terminal.

The easiest way to run Lemon is in Docker.

docker pull hexdolemonai/lemon-runtime-sandbox:latest

docker run -it --rm --pull=always \
  --name lemon-app \
  --env DOCKER_HOST_ADDR=host.docker.internal \
  --env ACTUAL_HOST_WORKSPACE_PATH=${WORKSPACE_BASE:-$PWD/workspace} \
  --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 \
  --volume ${WORKSPACE_BASE:-$PWD/data}:/app/data \
  --interactive \
  --tty \
  hexdolemonai/lemon:latest make run

For those who'd like to contribute code, see our Contribution Guide. At the same time, please consider supporting Lemon by sharing it on social media and at events and conferences.

We welcome your contribution to lemon to help improve lemon. Include: submit code, questions, new ideas, or share interesting and useful AI applications you have created based on lemon. We also welcome you to share lemon at different events, conferences and social media.

• GitHub Issues.Best for: bugs you encounter using Lemon.AI, and feature proposals. See our Contribution Guide.
• X(Twitter). Best for: sharing your applications and hanging out with the community.
• [commercial license]（[email protected]）. Business consulting on commercial use licensing lemon.

To protect your privacy, please avoid posting security issues on GitHub. Instead, send your questions to [email protected] and we will provide you with a more detailed answer.

This repository is available under the Lemon Open Source License, which is essentially Apache 2.0 with a few additional restrictions.