test

.env.example

@@ -1,24 +1,16 @@
-# LLM Environment variables
-
-# Reasoning LLM (for complex reasoning tasks)
-REASONING_API_KEY=sk-xxx
-REASONING_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
-REASONING_MODEL=qwq-plus
-
-# Non-reasoning LLM (for straightforward tasks)
-BASIC_API_KEY=sk-xxx
-BASIC_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
-BASIC_MODEL=qwen-max-latest
-
-# Vision-language LLM (for tasks requiring visual understanding)
-VL_API_KEY=sk-xxx
-VL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
-VL_MODEL=qwen2.5-vl-72b-instruct
-
 # Application Settings
 DEBUG=True
 APP_ENV=development
 
 # Add other environment variables as needed
 TAVILY_API_KEY=tvly-xxx
+# JINA_API_KEY=jina_xxx # Optional, default is None
+
 # CHROME_INSTANCE_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
+# CHROME_HEADLESS=False  # Optional, default is False
+# CHROME_PROXY_SERVER=http://127.0.0.1:10809  # Optional, default is None
+# CHROME_PROXY_USERNAME=  # Optional, default is None
+# CHROME_PROXY_PASSWORD=  # Optional, default is None
+
+# turn off for collecting anonymous usage information
+ANONYMIZED_TELEMETRY=false

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug Report
+about: Report a bug to help us improve LangManus
+title: ''
+labels: bug
+
+---
+
+Thank you for your support and contribution to LangManus!
+
+**Describe the Bug**
+A clear and concise description of the issue.
+
+**Steps to Reproduce**
+Please provide detailed steps to reproduce the issue:
+1. What actions did you take?
+2. What was the expected behavior?
+3. What actually happened?
+
+**Environment Information**
+Please provide the following details:
+- Operating System and Version: [e.g., Windows 10, macOS Ventura, Ubuntu 22.04]
+- Python Version: 3.12.7
+
+**Checklist**
+Before submitting this issue, please confirm the following:
+- [ ] I have read the `README.md` file thoroughly.
+- [ ] I have reviewed the `docs/faq.md` file and confirmed that this issue is not already addressed there.
+
+**Screenshots or Logs**
+If applicable, please attach screenshots or logs to help us understand the issue.
+
+**Additional Context**
+Add any other context or information about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,26 @@
+---
+name: Feature Request
+about: Suggest an idea or improvement for LangManus
+title: ''
+labels: enhancement
+
+---
+
+Thank you for your support and contribution to LangManus!
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of the problem or limitation. For example: "I'm always frustrated when [...]"
+
+**Describe the solution you'd like**
+A clear and concise description of the feature or improvement you would like to see.
+
+**Describe alternatives you've considered**
+If applicable, provide details of any alternative solutions or features you've considered.
+
+**Additional Context**
+Add any other context, screenshots, or examples to help explain your request.
+
+**Checklist**
+Before submitting this feature request, please confirm the following:
+- [ ] I have checked the existing issues and feature requests to ensure this is not a duplicate.
+- [ ] I have reviewed the `README.md` and `docs/faq.md` to ensure this feature is not already supported or addressed.

.github/workflows/build.yml

@@ -0,0 +1,56 @@
+name: Build and Push Docker Images
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha,format=short
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/lint.yml

@@ -0,0 +1,28 @@
+name: Lint Check
+
+on:
+  push:
+    branches: [ 'main' ]
+  pull_request:
+    branches: [ '*' ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Install the latest version of uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: |
+        uv venv --python 3.12
+        uv pip install -e ".[dev]"
+
+    - name: Run linters
+      run: |
+        source .venv/bin/activate
+        make lint

.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Test Cases Check
+
+on:
+  push:
+    branches: [ 'main' ]
+  pull_request:
+    branches: [ '*' ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Install the latest version of uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: |
+        uv venv --python 3.12
+        uv pip install -e ".[dev]"
+        uv pip install -e ".[test]"
+
+    - name: Run test cases
+      run: |
+        source .venv/bin/activate
+        OPENAI_API_KEY=mock-key DEEPSEEK_API_KEY=mock-key TAVILY_API_KEY=mock-key make test

.gitignore

@@ -7,11 +7,15 @@ wheels/
 *.egg-info
 .coverage
 agent_history.gif
+static/browser_history/*.gif
 
 # Virtual environments
 .venv
 
 # Environment variables
 .env
 
+# user conf
+conf.yaml
+
 .idea/

.vscode/launch.json

@@ -59,12 +59,23 @@
             "name": "Python: llm.py",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/src/agents/llm.py",
+            "program": "${workspaceFolder}/src/llms/llm.py",
             "console": "integratedTerminal",
             "justMyCode": true,
             "env": {
                 "PYTHONPATH": "${workspaceFolder}"
             }
+        },
+        {
+            "name": "Python: browser.py",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/src/tools/browser.py",
+            "console": "integratedTerminal",
+            "justMyCode": false,
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}"
+            }
         }
     ]
 }

CONTRIBUTING.md

@@ -23,9 +23,8 @@ There are many ways you can contribute to LangManus:
    ```
 3. Set up your development environment:
    ```bash
-   python -m venv .venv
-   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
-   uv sync
+   uv sync --all-extras
+   uv run playwright install
    ```
 4. Configure pre-commit hooks:
    ```bash

Dockerfile

@@ -0,0 +1,14 @@
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm
+WORKDIR /app
+ENV CHROME_HEADLESS=True
+COPY pyproject.toml uv.lock /app/
+
+RUN touch README.md
+RUN uv sync
+
+RUN uv run playwright install chromium --only-shell --with-deps
+
+COPY . /app
+
+CMD ["uv", "run", "python", "server.py"]
+

Makefile

@@ -1,7 +1,7 @@
-.PHONY: lint format install-dev serve
+.PHONY: lint format install-dev serve test coverage
 
 install-dev:
-	pip install -e ".[dev]"
+	uv pip install -e ".[dev]" && uv pip install -e ".[test]"
 
 format:
 	black --preview .
@@ -11,3 +11,9 @@ lint:
 
 serve:
 	uv run server.py
+
+test:
+	uv run pytest tests/
+
+coverage:
+	uv run pytest --cov=src tests/ --cov-report=term-missing