feat(ux): fix a few bugs and improve ux (#13)

* update default base url

* update .env readme

* fix https

* lint code

* lint

---------

Co-authored-by: Yue Deng <yue.deng@miromind.com>

Author: ntudy

README.md

@@ -160,8 +160,28 @@ uv sync
 
 **Step 2:** Set up environment dependencies:
 
+a. Set up `MiroFlow/apps/prepare-benchmark/.env` by:
+```bash
+## copy environment variable template and prepare yours in .env file
+cd MiroFlow/apps/prepare-benchmark
+cp .env.template .env
+vim .env 
+```
 Required environment variables:  
 - `HF_TOKEN` (for downloading datasets from Hugging Face) 
+
+Optional environment variables:
+- `DATA_DIR` (Data loading directory, by default `../../data`)
+
+
+b. Set up `MiroFlow/apps/run-agent/.env` by:
+```bash
+## copy environment variable template and prepare yours in .env file
+cd MiroFlow/apps/run-agent
+cp .env.template .env
+vim .env
+```
+Required environment variables:  
 - `OPENROUTER_API_KEY` (Using OpenRouter to provide primary agent model) 
 - `ANTHROPIC_API_KEY` (for vision tools)
 - `OPENAI_API_KEY` (for audio tools, intent recognition, and answer extraction)
@@ -176,15 +196,6 @@ Optional environment variables:
 
 If you wish to use a different LLM as the primary agent model, you will need to provide the corresponding API keys.
 
-```bash
-## copy environment variable template and prepare yours in .env file
-cd MiroFlow/apps/prepare-benchmark
-cp .env.template .env
-vim .env
-cd MiroFlow/apps/run-agent
-cp .env.template .env
-vim .env
-```
 
 **Step 3:** Prepare E2B Sandbox (Optional)
 

apps/run-agent/.env.template

@@ -8,15 +8,15 @@ GEMINI_API_KEY=""
 
 # Anthropic
 ANTHROPIC_API_KEY=""
-ANTHROPIC_BASE_URL=""
+ANTHROPIC_BASE_URL="https://api.anthropic.com"
 
 # openAI
 OPENAI_API_KEY=""
-OPENAI_BASE_URL=""
+OPENAI_BASE_URL="https://api.openai.com/v1"
 
 # openrouter
 OPENROUTER_API_KEY=""
-OPENROUTER_BASE_URL=""
+OPENROUTER_BASE_URL="https://openrouter.ai/api/v1"
 
 # NewAPI
 NEWAPI_API_KEY=""

libs/miroflow/src/miroflow/llm/providers/claude_anthropic_client.py

@@ -12,7 +12,7 @@
     DefaultAsyncHttpxClient,
     DefaultHttpxClient,
 )
-from omegaconf import DictConfig, OmegaConf
+from omegaconf import DictConfig
 from tenacity import retry, stop_after_attempt, wait_fixed
 
 from miroflow.llm.provider_client_base import LLMProviderClientBase
@@ -41,8 +41,8 @@ def _create_client(self, config: DictConfig):
         trace_id = get_trace_id()
         if trace_id is not None:
             http_client_args["headers"] = {"trace-id": trace_id}
-        if not OmegaConf.is_missing(config, "https_proxy"):
-            http_client_args["proxy"] = config.env.https_proxy
+        if (proxy := config.get("env.https_proxy", "???")) != "???":
+            http_client_args["proxy"] = proxy
             logger.debug(f"Info: Using proxy {http_client_args['proxy']}")
 
         if self.async_client: