pyproject.toml

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "agentflow-kit"
version = "0.1.0"
description = "Custom LLM framework for learning agentic AI patterns"
requires-python = ">=3.10"

dependencies = [
    # OpenAI-compatible HTTP client — used for openai, ollama, gemini, deepseek backends
    "openai>=1.50",
    # Anthropic native SDK — used for the anthropic backend
    "anthropic>=0.25",
    # .env file loading
    "python-dotenv>=1.0",
    # Adds the git repository root to sys.path so absolute imports work from any directory
    "git-root-to-syspath>=0.1",
    # Python wrapper for the graphviz system tool — used by Describable.get_svg/png/html/open_browser
    # System prerequisite: sudo apt install graphviz  (or: brew install graphviz)
    "graphviz>=0.20",
    # Immutable dict for State containers in agentflow.statemachine; see brief §1.2
    "frozendict>=2.4",
    # StateVertex is a Pydantic BaseModel; field validation for vertex parameters
    "pydantic>=2.0",
    "python-dateutil>=2.9.0.post0",
]

[project.scripts]
dot2html = "tools.dot2html:main"

[project.optional-dependencies]
gui = [
    # FastAPI + uvicorn for the optional local GUI server (agentflow[gui])
    "fastapi>=0.111",
    "uvicorn[standard]>=0.29",  # [standard] includes websockets + httptools
    "websockets>=12.0",
    # Syntax-highlighted source viewer for graph tooltip file links (/api/source)
    "pygments>=2.17",
    # Gemini TTS backend — high-quality speech synthesis via cloud API
    "google-genai>=1.0",
]
postgres = [
    # Async PostgreSQL driver for PostgresCheckpointStore
    "asyncpg>=0.29",
]
redis-backend = [
    # Async Redis client for RedisCheckpointStore
    "redis[asyncio]>=5.0",
]
# Extra deps used only in examples/ — not required for agentflow/
examples = [
    "python-dateutil>=2.8",
    # crewai and langgraph are large; install only when working with those examples
    # "crewai>=0.80",
    # "langgraph>=0.2",
    # "langchain-core>=0.3",
]
dev = [
    "pytest>=8.0",
    "pytest-asyncio>=0.23",
    "ruff>=0.4",
    "mypy>=1.10",
]

[tool.ruff]
line-length = 100
target-version = "py310"

[tool.ruff.lint]
select = ["E", "F", "I", "UP", "B", "SIM"]

[tool.setuptools.packages.find]
where = ["."]
include = ["agentflow*", "tools*"]

# Editable install on `uv sync` — imports `agentflow` from repo source (no copy).
[tool.uv]
package = true

[tool.mypy]
python_version = "3.10"
strict = true
mypy_path = "."

[tool.pytest.ini_options]
# Fallback when running pytest without venv sync; normal workflow uses editable install.
pythonpath = ["."]
testpaths = ["tests"]
asyncio_mode = "auto"

# Integration tests (marked @pytest.mark.integration) are EXCLUDED by default
# because they make real LLM API calls and cost money.
# Run them explicitly when needed:
#   pytest -m integration                        # integration only
#   pytest -m "not integration"                  # same as default
#   pytest -p no:randomly -m "unit or integration"  # all tests
addopts = "-m 'not integration'"

markers = [
    "unit: fast, no I/O — run on every save and in CI",
    "integration: live LLM API call — costs tokens, run explicitly only",
    "slow: > 5 s",
]