End to end local Integration test for parseImage function: See issue #1

.env.example

@@ -1,8 +1,45 @@
+# .env.example
+
 # Copy this file to .env and fill in your AWS credentials
+
+# --- Project ---
 PROJECT_NAME=omnimcp
+
+# --- Core LLM Configuration ---
+# Required for planning/reasoning steps (Only one provider needed usually)
 ANTHROPIC_API_KEY=your_anthropic_api_key
-# OPENAI_API_KEY=
-# GOOGLE_API_KEY=
-AWS_ACCESS_KEY_ID=your_access_key_id
-AWS_SECRET_ACCESS_KEY=your_secret_access_key
-AWS_REGION=us-east-1
+# Not yet supported:
+# OPENAI_API_KEY=your_openai_api_key
+# GOOGLE_API_KEY=your_google_api_key
+
+# Optional: Specify exact Anthropic model (defaults to "claude-3-7-sonnet-20250219" in config.py)
+# ANTHROPIC_DEFAULT_MODEL=claude-3-sonnet-20240229
+# ANTHROPIC_DEFAULT_MODEL=claude-3-haiku-20240307
+
+# --- OmniParser Service Configuration ---
+# Option 1: Leave blank/commented to use auto-deployment features (requires AWS keys below)
+# OMNIPARSER_URL=
+
+# Option 2: Specify URL if running OmniParser manually or elsewhere
+# OMNIPARSER_URL=http://<your_parser_ip>:8000
+
+# Optional: Factor (0.1-1.0) to resize screenshot before parsing (lower = faster, less accurate)
+# Default is 1.0 (no downsampling). Set to e.g. 0.5 for 50% scaling.
+# OMNIPARSER_DOWNSAMPLE_FACTOR=1.0
+
+# --- AWS Credentials (Required ONLY for OmniParser auto-deployment) ---
+# AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY
+# AWS_SECRET_ACCESS_KEY=YOUR_SECRET_KEY
+# AWS_REGION=us-east-1 # Optional: Defaults to us-east-1 if not set
+
+# --- Optional AWS EC2 Configuration (Overrides defaults in config.py for auto-deploy) ---
+# See config.py for default AMI/Instance Type (currently G6/DLAMI)
+# AWS_EC2_INSTANCE_TYPE=g6.xlarge
+# AWS_EC2_AMI=ami-xxxxxxxxxxxxxxxxx
+
+# --- Logging ---
+# Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL (Default: INFO)
+# LOG_LEVEL=INFO
+#
+# Optional: view full prompts in DEBUG mode
+# DEBUG_FULL_PROMPTS=False

.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  lint_and_test:
+    runs-on: ubuntu-latest
+
+    steps:
+      # --- 1. Checkout Repository ---
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # --- 2. Set up Python ---
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      # --- 3. Install uv ---
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+      - name: Add uv to PATH
+        run: echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+
+      # --- 4. Create Virtual Environment using uv --- ### ADDED STEP ###
+      - name: Create virtual environment
+        run: uv venv
+
+      # --- 5. Install Dependencies using uv --- ### Should now work ###
+      # uv pip install will now detect and use the .venv directory created above
+      - name: Install dependencies
+        run: uv pip install -e ".[test]"
+
+      # --- 6. Lint and Format Check with Ruff (via uv) ---
+      - name: Lint with Ruff
+        run: uv run ruff check .
+      - name: Check formatting with Ruff
+        run: uv run ruff format --check .
+
+      # --- 7. Run Tests with Pytest (via uv) ---
+      - name: Run tests
+        env:
+          ANTHROPIC_API_KEY: "ci_dummy_key"
+        run: uv run pytest tests/
+
+      # --- 8. Smoke test cli.lpy
+      - name: Run CLI Smoke Test (--help)
+        run: uv run python cli.py --help

.gitignore

@@ -4,3 +4,6 @@
 omnimcp.egg-info/
 omnimcp.log
 __pycache__
+runs/
+logs/
+images/*/