| # configuration.md — Configuration Reference | |
| Environment variables, secrets, and server configuration for LifeStack. | |
| --- | |
| ## Environment Variables | |
| Copy `.env.example` to `.env` and fill in values: | |
| ```bash | |
| cp .env.example .env | |
| ``` | |
| | Variable | Required | Description | | |
| |---|---|---| | |
| | `OPENAI_API_KEY` | For agent/training | API key for the LLM agent and GRPO reward function | | |
| | `GROQ_API_KEY` | Optional | Alternative fast-inference backend | | |
| | `GMAIL_CREDENTIALS_PATH` | Optional | Path to Gmail OAuth2 credentials JSON | | |
| > **Never commit `.env`** — it is listed in `.gitignore`. | |
| --- | |
| ## `openenv.yaml` | |
| Defines the OpenEnv service manifest for MCP / REST integration. | |
| ```yaml | |
| name: lifestack | |
| version: "1.1.0" | |
| entry: server.py | |
| port: 8000 | |
| ``` | |
| Edit this file if you rename the server entry point or change the port. | |
| --- | |
| ## Gradio App | |
| Configured in `app.py` `__main__` block: | |
| ```python | |
| app.launch( | |
| share=False, | |
| server_port=7860, | |
| show_error=True, | |
| ) | |
| ``` | |
| Change `server_port` or set `share=True` for a public Gradio link. | |
| --- | |
| ## Docker | |
| ```bash | |
| docker build -t lifestack:latest . | |
| docker run -p 7860:7860 --env-file .env lifestack:latest | |
| ``` | |
| The `Dockerfile` installs `requirements.txt` and runs `python app.py`. | |
| --- | |
| ## Change Log | |
| | Date | Change | | |
| |---|---| | |
| | 2026-04-23 | Initial doc created | | |