From 099e0c221c38e4fe174c1a67afe28dbaaf722f9a Mon Sep 17 00:00:00 2001 From: warren Date: Fri, 11 Jul 2025 16:41:23 +0800 Subject: [PATCH] modify the way to setup venv --- README.md | 36 +++++++++++++++++++++++++++--------- requirements.txt | 42 ++++++++++++++++++++++++++++++++++++++---- 2 files changed, 65 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 7a0b56f..6b28350 100644 --- a/README.md +++ b/README.md @@ -30,28 +30,46 @@ A Model Context Protocol (MCP) service that provides PowerPoint translation capa ## Installation -### Quick Setup +### Virtual Environment Setup (Recommended) ```bash # Clone the repository git clone https://github.com/yourusername/mcpppttranslator.git cd mcpppttranslator -# Install dependencies -python server.py --install-deps +# Create virtual environment +python3 -m venv venv + +# Activate virtual environment +source venv/bin/activate # On macOS/Linux +# or +venv\Scripts\activate # On Windows + +# Install all dependencies with exact versions +pip install -r requirements.txt -# Or use uv for faster installation -python server.py --install-deps --use-uv +# Verify installation +python3 server.py --list-languages ``` -### Virtual Environment Setup (Recommended) +### Alternative Setup with Project Script ```bash -# Create virtual environment with uv -python server.py --install-deps --use-uv --venv +# Note: The project script may have issues with dependency detection +# Use the standard method above for reliable installation + +# If you have uv installed globally, you can try: +python3 server.py --install-deps --use-uv --venv # Or specify custom path -python server.py --install-deps --use-uv --venv --venv-path /path/to/custom/venv +python3 server.py --install-deps --use-uv --venv --venv-path /path/to/custom/venv +``` + +### Direct Installation (Not Recommended) + +```bash +# Install dependencies globally (not recommended) +pip install -r requirements.txt ``` ## MCP Configuration diff --git a/requirements.txt b/requirements.txt index 873d263..a35572c 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,4 +1,38 @@ -python-pptx>=0.6.21 -boto3>=1.28.0 -python-dotenv>=1.0.0 -mcp>=1.0.0 +annotated-types==0.7.0 +anyio==4.9.0 +attrs==25.3.0 +boto3==1.39.4 +botocore==1.39.4 +certifi==2025.7.9 +click==8.2.1 +h11==0.16.0 +httpcore==1.0.9 +httpx==0.28.1 +httpx-sse==0.4.1 +idna==3.10 +jmespath==1.0.1 +jsonschema==4.24.0 +jsonschema-specifications==2025.4.1 +lxml==6.0.0 +mcp==1.11.0 +pillow==11.3.0 +pydantic==2.11.7 +pydantic-settings==2.10.1 +pydantic_core==2.33.2 +python-dateutil==2.9.0.post0 +python-dotenv==1.1.1 +python-multipart==0.0.20 +python-pptx==1.0.2 +referencing==0.36.2 +rpds-py==0.26.0 +s3transfer==0.13.0 +six==1.17.0 +sniffio==1.3.1 +sse-starlette==2.4.1 +starlette==0.47.1 +typing-inspection==0.4.1 +typing_extensions==4.14.1 +urllib3==2.5.0 +uv==0.7.20 +uvicorn==0.35.0 +xlsxwriter==3.2.5