---
title: Mesop App Maker
emoji: 🏭
colorFrom: yellow
colorTo: pink
sdk: docker
pinned: false
license: apache-2.0
app_port: 8080
---
# Mesop App Maker
Editor to generate, edit, and view Mesop apps using LLMs.
## Usage
The Mesop App Maker consists of two Mesop apps, the editor and the app runner.
### The editor
The editor is the Mesop app that allows you to generate, edit, and view Mesop apps.
```shell
pip install -r requirements.txt
mesop main.py
```
#### Environment variables
The editor supports the following environment variables. These are mainly useful for
local development where you don't want to keep entering your API Key and runner token
after every reload.
```
GEMINI_API_KEY=you-gemini-api-key
MESOP_APP_MAKER_RUNNER_URL=https://example.com
MESOP_APP_MAKER_RUNNER_TOKEN=your-secret-token
MESOP_APP_MAKER_SHOW_HELP=0
```
You will need a Gemini API key to use the Mesop app generate functionality.
### The runner
> The runner has been moved to https://github.com/richard-to/mesop-app-runner.
The [Mesop App Runner](https://github.com/richard-to/mesop-app-runner) uses Docker to avoid potentially destructive code changes.
It can be started using these commands:
```shell
# In mesop-app-runner directory
docker stop mesop-app-runner;
docker rm mesop-app-runner;
docker build -t mesop-app-runner . && docker run --name mesop-app-runner \
-e MESOP_APP_RUNNER_TOKEN=your-secret-token \
-d -p 8080:8080 mesop-app-runner;
```
## Screenshots
### Generate app
### Preview app
### Hugging Face
If you want to test out the [Mesop App Maker](https://huggingface.co/spaces/richard-to/mesop-app-maker) on Hugging Face,
you will need to create your own instance of the [Mesop App Runner](https://huggingface.co/spaces/richard-to/mesop-app-runner).
You can do this by duplicating the [Mesop App Runner](https://huggingface.co/spaces/richard-to/mesop-app-runner) on Hugging Face.
This can be done on the [Mesop App Runner](https://huggingface.co/spaces/richard-to/mesop-app-runner) space like this:
Make sure to specify a `MESOP_APP_RUNNER_TOKEN`. This can be any random characters. It is needed to ensure that only people
with the token can run Mesop code on your runner instance.
The URL will be something like `https://-.hf.space`.
You will need to provide this URL as the Runner URL on [Mesop App Maker](https://huggingface.co/spaces/richard-to/mesop-app-maker).
You will also need to provide the runner token associated with your instance on [Mesop App Maker](https://huggingface.co/spaces/richard-to/mesop-app-maker).
