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

document

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.

complex task solving: lemon can solve various complex and changeable tasks, including but not limited to market research, document processing, travel planning and data analysis. Through independent thinking and system planning, it can flexibly call various tools in the virtual environment, such as writing and executing code, intelligently browsing web pages, operating web applications, etc.

autonomy and goal orientation: lemon has a high degree of autonomy and can complete tasks independently without human intervention. It can perceive, reason, make decisions and act according to the preset goals.

real time task monitoring : users can view the execution status of tasks in real time through the page side

multi scenario coverage : complex task processing in the fields of market research, financial analysis, data analysis, code programming, life planning, etc.

self subscription mode: in addition to the default model , supports user-defined model access and online model access, which can be used through the configuration 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.