eigent/backend

# Option 1: Start with uvicorn directly
uv run uvicorn main:api --port 5001

# Option 2: Standalone mode (no Electron dependency)
uv run python main.py

# Option 3: If uv run hangs, delete lock files and retry, or use venv directly:
.venv/bin/python main.py
# or
.venv/bin/uvicorn main:api --port 5001 --host 0.0.0.0

# If uv hangs, delete lock files first: rm -f uv_installing.lock uv_installed.lock

Environment Variables (Standalone)

Variable	Default	Description
EIGENT_BRAIN_PORT	5001	Listening port
EIGENT_BRAIN_HOST	0.0.0.0	Listening address
EIGENT_DEBUG	-	Set to 1/true to enable reload
EIGENT_WORKSPACE	~/.eigent/workspace	Working directory
EIGENT_DEPLOYMENT_TYPE	(auto)	local / cloud_vm / sandbox / docker; determines Hands capabilities (see ADR-0006)
EIGENT_HANDS_MODE	-	Set to remote to enable RemoteHands (remote cluster resource mode)
EIGENT_HANDS_CLUSTER_CONFIG_FILE	-	Path to RemoteHands config file (TOML); recommended
EIGENT_HANDS_TERMINAL	-	Override terminal hand: 1/true/yes or 0/false/no
EIGENT_HANDS_BROWSER	-	Override browser hand
EIGENT_HANDS_FILESYSTEM	-	Override filesystem scope: full / workspace_only
EIGENT_HANDS_MCP	-	Override MCP mode: all / allowlist

RemoteHands config file example:

cp backend/config/hands_clusters.example.toml ~/.eigent/hands_clusters.toml
export EIGENT_HANDS_MODE=remote
export EIGENT_HANDS_CLUSTER_CONFIG_FILE=~/.eigent/hands_clusters.toml

i18n operation process: https://github.com/Anbarryprojects/fastapi-babel

pybabel extract -F babel.cfg -o messages.pot . --ignore-pot-creation-date  # Extract multilingual strings from code to messages.pot file
pybabel init -i messages.pot -d lang -l zh_CN   # Generate Chinese language pack, can only be generated initially, subsequent execution will cause overwrite
pybabel compile -d lang -l zh_CN                # Compile language pack


pybabel update -i messages.pot -d lang
# -i messages.pot: Specify the input file as the generated .pot file
# -d translations: Specify the translation directory, which typically contains .po files for each language
# -l zh: Specify the language code

# regular search
\berror\b(?!\])