pyproject.toml

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "camel-ai"
version = "0.2.38"
description = "Communicative Agents for AI Society Study"
authors = [{ name = "CAMEL-AI.org" }]
requires-python = ">=3.10,<3.13"
readme = "README.md"
license = "Apache-2.0"
keywords = [
    "communicative-ai",
    "ai-societies",
    "artificial-intelligence",
    "deep-learning",
    "multi-agent-systems",
    "cooperative-ai",
    "natural-language-processing",
    "large-language-models",
]
dependencies = [
    "openai>=1.68.0,<2",
    "tiktoken>=0.7.0,<0.8",
    "colorama>=0.4.6,<0.5",
    "jsonschema>=4,<5",
    "docstring-parser>=0.15,<0.16",
    "pydantic>=1.9,<2.10",
    "httpx>=0.28.0,<1.0.0dev",
    "psutil>=5.9.8,<6",
]

[project.optional-dependencies]
test = [
    "pytest>=7,<8",
    "mock>=5,<6",
    "pytest-asyncio>=0.23.0,<0.24",
]
dev = [
    "ruff>=0.7,<0.8",
    "mypy>=1.5.1,<2",
    "toml>=0.10.2",
    "pre-commit>=3,<4",
    "pytest>=7,<8",
    "pytest-cov>=4,<5",
    "pytest-asyncio>=0.23.0,<0.24",
    "gradio>=3,<4",
    "mock>=5,<6",
    "types-colorama>=0.4.15,<0.5",
    "types-PyYAML>=6.0.12,<7",
    "types-mock>=5.1.0,<6",
    "types-tqdm>=4.66.0,<5",
    "types-requests>=2.31.0,<3",
    "types-setuptools>=69.2.0,<70",
    "uv==0.6.5",
]
docs = [
    "sphinx>=7,<8",
    "sphinx_book_theme",
    "docutils<0.20.0",
    "myst-parser",
    "nbsphinx",
    "sphinxext-rediraffe>=0.2.7,<0.3",
]
rag = [
    "numpy~=1.26",
    "sentence-transformers>=3.0.1,<4",
    "qdrant-client>=1.9.0,<2",
    "pymilvus>=2.4.0,<3",
    "pytidb-experimental==0.0.1.dev4",
    "neo4j>=5.18.0,<6",
    "nebula3-python==3.8.2",
    "rank-bm25>=0.2.2,<0.3",
    "cohere>=5.11.0,<6",
    "unstructured==0.16.20",
    "pandasai>=2.3.0,<3",
]
web_tools = [
    "duckduckgo-search>=6.3.5,<7",
    "wikipedia>=1,<2",
    "firecrawl-py>=1.0.0,<2",
    "apify_client>=1.8.1,<2",
    "linkup-sdk>=0.2.1,<0.3",
    "wolframalpha>=5.0.0,<6",
    "tavily-python>=0.5.0,<0.6",
    "dappier>=0.3.3,<0.4",
    "newspaper3k>=0.2.8,<0.3",
    "pyowm>=3.3.0,<4",
    "googlemaps>=4.10.0,<5",
    "requests_oauthlib>=1.3.1,<2",
    "sympy>=1.13.3,<2",
    "fastapi>=0.115.11",
    "playwright>=1.50.0",
    "html2text>=2024.2.26",
    "beautifulsoup4>=4,<5",
]
document_tools = [
    "numpy~=1.26",
    "beautifulsoup4>=4,<5",
    "docx2txt>=0.8,<0.9",
    "PyMuPDF>=1.22.5,<2",
    "unstructured==0.16.20",
    "pandasai>=2.3.0,<3",
    "prance>=23.6.21.0,<24",
    "openapi-spec-validator>=0.7.1,<0.8",
    "xls2xlsx>=0.2.0",
    "tabulate>=0.9.0",
    "openpyxl>=3.1.5",
    "docx>=0.2.4",
    "fpdf>=1.7.2",
]
media_tools = [
    "imageio[pyav]>=2.34.2,<3",
    "pillow>=10.1.0,<11.0.0",
    "pydub>=0.25.1,<0.26",
    "yt-dlp>=2024.11.4,<2025",
    "ffmpeg-python>=0.2.0,<0.3",
    "scenedetect>=0.6.5.2",
]
communication_tools = [
    "slack-sdk>=3.27.2,<4",
    "slack-bolt>=1.20.1,<2",
    "pygithub>=2.6.0,<3",
    "pyTelegramBotAPI>=4.18.0,<5",
    "discord.py>=2.3.2,<3",
    "notion-client>=2.2.1,<3",
    "praw>=7.7.1,<8",
]
data_tools = [
    "numpy~=1.26",
    "pandas>=1.5.3,<2",
    "textblob>=0.17.1,<0.18",
    "datacommons>=1.4.3,<2",
    "datacommons_pandas>=0.0.3,<0.0.4",
    "rouge>=1.0.1,<2",
    "aiosqlite>=0.20.0,<0.21",
    "stripe>=11.3.0,<12",
    "networkx>=3.4.2,<4",
    "math-verify>=0.7.0,<0.8", 
]
research_tools = [
    "arxiv>=2.1.3,<3",
    "arxiv2text>=0.1.14,<0.2",
    "scholarly[tor]==1.7.11",
]
dev_tools = [
    "docker>=7.1.0,<8",
    "jupyter_client>=8.6.2,<9",
    "ipykernel>=6.0.0,<7",
    "agentops>=0.3.21,<0.4",
    "e2b-code-interpreter>=1.0.3,<2",
    "tree-sitter-python>=0.23.6,<0.24",
    "tree-sitter>=0.23.2,<0.24",
    "typer>=0.15.2",
    "mcp>=1.3.0",
]
model_platforms = [
    "litellm>=1.38.1,<2",
    "mistralai>=1.1.0,<2",
    "reka-api>=3.0.8,<4",
    "anthropic>=0.47.0,<0.50.0",
    "cohere>=5.11.0,<6",
    "fish-audio-sdk>=2024.12.5,<2025",
]
huggingface = [
    "transformers>=4,<5",
    "diffusers>=0.25.0,<0.26",
    "accelerate>=0.26.0,<0.27",
    "datasets>=3,<4",
    "torch",
    "soundfile>=0.13,<0.14",
    "sentencepiece>=0.2,<0.3",
    "opencv-python>=4,<5",
]
storage = [
    "qdrant-client>=1.9.0,<2",
    "pymilvus>=2.4.0,<3",
    "pytidb-experimental==0.0.1.dev4",
    "neo4j>=5.18.0,<6",
    "nebula3-python==3.8.2",
    "redis>=5.0.6,<6",
    "azure-storage-blob>=12.21.0,<13",
    "google-cloud-storage>=2.18.0,<3",
    "botocore>=1.35.3,<2",
    "mem0ai>=0.1.73"
]
owl = [
    "numpy~=1.26",
    "chunkr-ai>=0.0.41",
    "mcp-simple-arxiv==0.2.2",
    "mcp-server-fetch==2025.1.17",
    "outlines>=0.1.7,<0.2",
    "python-dotenv>=1.0.0,<2",
    "transformers>=4,<5",
    "sentencepiece>=0.2,<0.3",
    "anthropic>=0.47.0,<0.50.0",
    "datasets>=3,<4",
    "soundfile>=0.13,<0.14",
    "pydub>=0.25.1,<0.26",
    "ffmpeg-python>=0.2.0,<0.3",
    "pillow>=10.1.0,<11.0.0",
    "opencv-python>=4,<5",
    "imageio[pyav]>=2.34.2,<3",
    "yt-dlp>=2024.11.4,<2025",
    "scenedetect>=0.6.5.2",
    "beautifulsoup4>=4,<5",
    "docx2txt>=0.8,<0.9",
    "PyMuPDF>=1.22.5,<2",
    "unstructured==0.16.20",
    "pandasai>=2.3.0,<3",
    "prance>=23.6.21.0,<24",
    "openapi-spec-validator>=0.7.1,<0.8",
    "xls2xlsx>=0.2.0",
    "tabulate>=0.9.0",
    "openpyxl>=3.1.5",
    "docx>=0.2.4",
    "fpdf>=1.7.2",
    "duckduckgo-search>=6.3.5,<7",
    "wikipedia>=1,<2",
    "newspaper3k>=0.2.8,<0.3",
    "playwright>=1.50.0",
    "html2text>=2024.2.26",
    "requests_oauthlib>=1.3.1,<2",
    "e2b-code-interpreter>=1.0.3,<2",
    "typer>=0.15.2",
    "tree-sitter-python>=0.23.6,<0.24",
    "tree-sitter>=0.23.2,<0.24",
    "pandas>=1.5.3,<2",
    "rouge>=1.0.1,<2",
]
all = [
    "numpy~=1.26",
    "transformers>=4,<5",
    "diffusers>=0.25.0,<0.26",
    "accelerate>=0.26.0,<0.27",
    "datasets>=3,<4",
    "torch",
    "soundfile>=0.13,<0.14",
    "sentencepiece>=0.2,<0.3",
    "opencv-python>=4,<5",
    "beautifulsoup4>=4,<5",
    "docx2txt>=0.8,<0.9",
    "PyMuPDF>=1.22.5,<2",
    "unstructured==0.16.20",
    "pandasai>=2.3.0,<3",
    "wikipedia>=1,<2",
    "linkup-sdk>=0.2.1,<0.3",
    "duckduckgo-search>=6.3.5,<7",
    "newspaper3k>=0.2.8,<0.3",
    "wolframalpha>=5.0.0,<6",
    "sympy>=1.13.3,<2",
    "pyowm>=3.3.0,<4",
    "googlemaps>=4.10.0,<5",
    "requests_oauthlib>=1.3.1,<2",
    "fastapi>=0.115.11",
    "prance>=23.6.21.0,<24",
    "openapi-spec-validator>=0.7.1,<0.8",
    "rouge>=1.0.1,<2",
    "aiosqlite>=0.20.0,<0.21",
    "outlines>=0.1.7,<0.2",
    "e2b-code-interpreter>=1.0.3,<2",
    "firecrawl-py>=1.0.0,<2",
    "arxiv>=2.1.3,<3",
    "arxiv2text>=0.1.14,<0.2",
    "imageio[pyav]>=2.34.2,<3",
    "pillow>=10.1.0,<11.0.0",
    "slack-sdk>=3.27.2,<4",
    "slack-bolt>=1.20.1,<2",
    "pydub>=0.25.1,<0.26",
    "pygithub>=2.6.0,<3",
    "pyTelegramBotAPI>=4.18.0,<5",
    "discord.py>=2.3.2,<3",
    "docker>=7.1.0,<8",
    "jupyter_client>=8.6.2,<9",
    "ipykernel>=6.0.0,<7",
    "agentops>=0.3.21,<0.4",
    "praw>=7.7.1,<8",
    "textblob>=0.17.1,<0.18",
    "scholarly[tor]==1.7.11",
    "notion-client>=2.2.1,<3",
    "yt-dlp>=2024.11.4,<2025",
    "ffmpeg-python>=0.2.0,<0.3",
    "datacommons>=1.4.3,<2",
    "datacommons_pandas>=0.0.3,<0.0.4",
    "tavily-python>=0.5.0,<0.6",
    "apify_client>=1.8.1,<2",
    "stripe>=11.3.0,<12",
    "pandas>=1.5.3,<2",
    "tree-sitter-python>=0.23.6,<0.24",
    "tree-sitter>=0.23.2,<0.24",
    "networkx>=3.4.2,<4",
    "qdrant-client>=1.9.0,<2",
    "pymilvus>=2.4.0,<3",
    "pytidb-experimental==0.0.1.dev4",
    "cohere>=5.11.0,<6",
    "sentence-transformers>=3.0.1,<4",
    "neo4j>=5.18.0,<6",
    "nebula3-python==3.8.2",
    "rank-bm25>=0.2.2,<0.3",
    "litellm>=1.38.1,<2",
    "mistralai>=1.1.0,<2",
    "fish-audio-sdk>=2024.12.5,<2025",
    "anthropic>=0.47.0,<0.50.0",
    "reka-api>=3.0.8,<4",
    "redis>=5.0.6,<6",
    "azure-storage-blob>=12.21.0,<13",
    "google-cloud-storage>=2.18.0,<3",
    "botocore>=1.35.3,<2",
    "dappier>=0.3.3,<0.4",
    "mypy>=1.5.1,<2",
    "pre-commit>=3,<4",
    "types-colorama>=0.4.15,<0.5",
    "types-PyYAML>=6.0.12,<7",
    "types-mock>=5.1.0,<6",
    "types-tqdm>=4.66.0,<5",
    "types-requests>=2.31.0,<3",
    "types-setuptools>=69.2.0,<70",
    "pytest>=7,<8",
    "pytest-cov>=4,<5",
    "pytest-asyncio>=0.23.0,<0.24",
    "gradio>=3,<4",
    "mock>=5,<6",
    "xls2xlsx>=0.2.0",
    "tabulate>=0.9.0",
    "openpyxl>=3.1.5",
    "scenedetect>=0.6.5.2",
    "playwright>=1.50.0",
    "html2text>=2024.2.26",
    "docx>=0.2.4",
    "fpdf>=1.7.2",
    "mcp>=1.3.0",
    "typer>=0.15.2",
    "mem0ai>=0.1.67",
    "math-verify>=0.7.0,<0.8",
]

[project.urls]
Homepage = "https://www.camel-ai.org/"
Repository = "https://github.com/camel-ai/camel"
Documentation = "https://docs.camel-ai.org"

[tool.uv]
default-groups = [
    "dev",
    "docs",
]

[tool.hatch.build.targets.sdist]
include = ["camel"]

[tool.hatch.build.targets.wheel]
include = ["camel"]

[tool.ruff]
line-length = 79
fix = true
target-version = "py310"

[tool.ruff.format]
quote-style = "preserve"

[tool.ruff.lint]
extend-select = [
    "I", # isort
    "B", # flake8-bugbear
    "C4", # flake8-comprehensions
    "PGH", # pygrep-hooks
    "RUF", # ruff
    "E",
]

ignore = [
    "B028", # Warning without stacklevel
    "B904", # use 'raise ... from err'
    "B905", # use explicit 'strict=' parameter with 'zip()'
    "N818", #  Exception name should be named with an Error suffix
    "C416", # I think comprehension is more clear https://docs.astral.sh/ruff/rules/unnecessary-comprehension/
    "C408", # we have used lots of dict(...) instead of literal
]

[tool.ruff.lint.pydocstyle]
convention = "google"

[tool.ruff.lint.isort]
known-first-party = ["camel"]

[tool.pytest.ini_options]
pythonpath = ["."]
addopts = ["--strict-markers"]
markers = [
    "asyncio: mark a test as asyncio-based.",
    "very_slow: mark a very slow test to run only in full test mode",
    "model_backend: for tests that require OpenAI API key or a local LLM",
]

[tool.coverage.report]
include_namespace_packages = true

[tool.mypy]
exclude = [
    '\.venv/.*',  # exclude .venv directory
    'site-packages/.*',  # exclude site-packages
]

[[tool.mypy.overrides]]
module = [
    "transformers.*",
    "packaging.*",
    "tiktoken",
    "openai",
    "openai.error",
    "anthropic",
    "pytest",
    "psutil",
    "_pytest.config",
    "_pytest.nodes",
    "numpy",
    "torch",
    "sqlalchemy",
    "google.cloud.sql.connector",
    "gradio",
    "database_connection",
    "huggingface_hub",
    "huggingface_hub.utils._errors",
    "huggingface_hub.errors",
    "wikipedia",
    "linkup-sdk",
    "duckduckgo_search",
    "newspaper",
    "wolframalpha",
    "pyowm",
    "googlemaps",
    "requests_oauthlib",
    "fastapi",
    "prance",
    "xls2xlsx",
    "tabulate",
    "openpyxl",
    "openapi-spec-validator",
    "jsonschema.*",
    "bs4.*",
    "docx2txt",
    "PyMuPDF",
    "fitz",
    "qdrant_client.*",
    "unstructured.*",
    "rouge",
    "aiosqlite",
    "e2b_code_interpreter",
    "firecrawl",
    "imageio",
    "rank_bm25",
    "cohere",
    "fish_audio_sdk",
    "sentence_transformers.*",
    "pymilvus",
    "pytidb",
    "pillow",
    "slack-sdk",
    "slack-bolt",
    "pydub",
    "pygithub",
    "litellm",
    "pyTelegramBotAPI",
    "dappier",
    "discord.py",
    "docker.*",
    "google.*",
    "google_generativeai",
    "mistralai",
    "cohere",
    "fish-audio-sdk",
    "reka-api",
    "agentops",
    "botocore.*",
    "arxiv",
    "arxiv2text",
    "praw",
    "textblob",
    "datacommons",
    "datacommons_pandas",
    "tavily-python",
    "scholarly",
    "notion-client",
    "ffmpeg",
    "yt_dlp",
    "datasets",
    "pandas",
    "tree-sitter-python",
    "tree-sitter",
    "networkx",
    "pandasai",
    "sklearn.metrics.pairwise",
    "sympy",
    "astor",
    "tqdm",
    "colorama",
    "yaml",
    "mock",
    "uvicorn",
    "xls2xlsx",
    "tabulate",
    "openpyxl",
    "scenedetect",
    "scenedetect.detectors",
    "playwright",
    "html2text",
    "docx",
    "fpdf",
    "mcp",
    "typer",
    "mem0",
    "math_verify.*"
]
ignore_missing_imports = true