pyproject.toml

[tool.hatch.version]
source = "regex_commit"
commit_extra_args = ["-e"]
path = "src/llmling_agent/__init__.py"

[tool.hatch.build.targets.wheel]
packages = [
    "src/llmling_agent",
    "src/llmling_agent_web",
    "src/llmling_agent_cli",
    "src/llmling_agent_tools",
    "src/llmling_agent_commands",
    "src/llmling_agent_providers",
    "src/llmling_agent_storage",
    "src/llmling_agent_functional",
    "src/llmling_agent_docs",
    "src/llmling_agent_events",
    "src/llmling_agent_converters",
    "src/llmling_agent_prompts",
    "src/llmling_agent_models",
    "src/llmling_agent_observability",
    "src/llmling_agent_running",
    "src/llmling_textual",
]

[build-system]
requires = ["hatchling", "hatch-regex-commit"]
build-backend = "hatchling.build"

[project]
name = "llmling-agent"
description = "A brand new AI framework.  Fully async. Excellently typed. Pydantic-Ai + LiteLLM support. Human in the loop. Unique messaging features."
authors = [
    { name = "Philipp Temminghoff", email = "philipptemminghoff@googlemail.com" },
]
readme = "README.md"
dynamic = ["version"]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3 :: Only",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Topic :: Documentation",
    "Topic :: Software Development",
    "Topic :: Utilities",
    "Typing :: Typed",

]
keywords = []
requires-python = ">=3.12"
license = { file = "LICENSE" }
dependencies = [
    "llmling>=1.0.0",
    "pydantic",
    # these 4 could be optional, but until we get deeper into pyodide (which is not working
    # with pydantic-ai), we will keep them here.
    "prompt-toolkit>=3.0.48",
    "promptantic>=0.4.5",
    "pydantic_ai",
    "llmling-models",
    # Only add below (Copier)
    "python-dotenv>=1.0.1",
    "sqlmodel>=0.0.22",
    "aiosqlite>=0.19.0",
    "typer>=0.15.1",
    "psygnal>=0.11.1",
    "tokonomics>=0.1.2",
    "slashed>=0.1.0",
    "toprompt>=0.0.1",
    "mcp>=1.2.0",
    "griffe>=1.5.4",
    "morefs[asynclocal]",
    "bigtree>=0.23.1",
    "typing_extensions",
]

[project.scripts]
llmling-agent = "llmling_agent.__main__:cli"

[project.optional-dependencies]
ui = ["gradio>=5.8.0"]
# chat = ["prompt-toolkit>=3.0.48", "promptantic>=0.4.5"]
clipboard = ["clipman"]
tiktoken = ["tiktoken"]
markdown = ["markitdown"]
events = ["watchfiles", "aioimaplib>=2.0.1", "croniter>=6.0.0"]
textual = ["textual>=1.0.0", "textualicious"]
litellm = ["litellm"]
image = ["pillow"]
# pydantic_ai = ["pydantic_ai", "llmling-models"]
remote = ["websockets>=14.2"]
mem0 = ["mem0ai>=0.1.48"]
logfire = ["logfire"]
agentops = ["agentops"]
arize = [
    "arize",
    "arize-phoenix-otel",
    "openinference-instrumentation-litellm",
    "openinference-instrumentation-openai",
]
mlflow = ["mlflow>=2.20.1"]
langsmith = ["langsmith"]

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

[dependency-groups]
dev = [
    "pytest",
    "pytest-cov",
    "pytest-xdist",
    "pyreadline3",
    "devtools",
    # Only add below (Copier)
    "pytest-asyncio>=0.24.0",
    "textual-dev>=1.7.0",
    "openapi_spec_validator",
]
benchmark = ["pyinstrument"]
lint = [
    "ruff",
    "mypy[faster-cache]; python_version < '3.14'",
    "mypy; python_version >= '3.14'",
    # Only add below (Copier)
]
docs = [
    "mkdocs-mknodes",
    "mkdocs-material",
    # Only add below (Copier)
]

[project.urls]
Documentation = "https://phil65.github.io/llmling-agent/"
Source = "https://github.com/phil65/llmling-agent"
Issues = "https://github.com/phil65/llmling-agent/issues"
Discussions = "https://github.com/phil65/llmling-agent/discussions"
"Code coverage" = "https://app.codecov.io/gh/phil65/llmling-agent"

[tool.pytest.ini_options]
testpaths = ["tests"]
log_cli = true
python_files = ["test_*.py"]
pythonpath = ["src"]
log_level = "ERROR"
asyncio_default_fixture_loop_scope = "function"
log_format = "%(asctime)s %(levelname)s %(message)s"
log_date_format = "%Y-%m-%d %H:%M:%S"
asyncio_mode = "auto"
addopts = "-m 'not slow'"
markers = [
    "asyncio: mark test as async",
    "slow: marks tests as slow",
    "unit: marks tests as unit tests",
    "integration: marks tests as integration tests",
]
filterwarnings = [
    "ignore::DeprecationWarning:pydantic.*:",
    "ignore::UserWarning:pydantic.*:",        # caused by litellm
    "ignore::DeprecationWarning:litellm.*:",
    "ignore::DeprecationWarning:typer.*",
]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "if TYPE_CHECKING:",
    "@overload",
    "except ImportError",
    'if __name__ == "__main__":',
]

[tool.mypy]
python_version = "3.12"
disable_error_code = ["misc", "import"]
pretty = true
check_untyped_defs = true
exclude = ['venv/', '.venv/', 'tests/']
plugins = ["pydantic.mypy"]

[tool.ruff]
line-length = 90
extend-exclude = ['docs']
target-version = "py312"

[tool.ruff.lint]
select = [
    "A", # Flake8-builtins
    # "ANN",  # Flake8-Annotations
    # "ASYNC",  # Flake8-Async
    # "ARG",  # # Flake8-Unused-Arguments
    "B",   # flake8-bugbear
    "BLE", # Flake8-blind-except
    "C",
    "C4",  # flake8-comprehensions
    # "C90",  # MCCabe
    "COM", #  Flake8-commas
    # "CPY",  #  Copyright-related rules
    "D", # PyDocStyle
    # "DTZ",  # Flake8- Datetimez
    "E",  # PyCodeStyle Error
    "EM", # flake8-errmsg
    # "ERA",  #  Eradicate
    "EXE", # flake8-executable
    "F",   # PyFlakes
    "FA",  # flake8-future-annotations
    # "FBT",  # flake8-boolean-trap
    # "FIX",  # flake8-fixme
    "FLY", # flynt
    "G",   #  flake8-logging-format
    "I",   # ISort
    "ICN", # Flake8-import-conventions
    "INP", # flake8-no-pep420
    "INT", # flake8-gettext
    "ISC", # flake8-implicit-str-concat
    "N",   # pep8-naming
    # "NPY",  # numpy-specific rules
    # "PD",   # pandas-vet
    "PERF", # perflint
    # "PGH",  # pygrep-hooks
    "PIE", # flake8-pie
    "PLE", # PyLint Error
    "PLC", # PyLint convention
    # "PLW",  # PyLint Warning
    "PLR", # PyLint refactor
    "PT",  # flake8-pytest-style
    "PTH", # flake8-use-pathlib
    "PYI", # flake8-pyi
    "Q",   # flake8-quotes
    "RET", # flake8-return
    "RSE", # flake8-raise
    "RUF", # ruff-specific rules
    # "S",    # flake8-bandit
    "SIM",  # flake8-simplify
    "SLF",  # flake8-self
    "SLOT", # flake8-slots
    # "T",
    # "TD",   # flake8-todos
    "T10", # flake8-debugger
    # "T20",  # flake8-print
    "TC",  # flake8-type-checking
    "TID", # flake8-tidy-imports
    "TRY", # tryceratops
    "UP",  # PyUpgrade
    "W",   # PyCodeStyle warning
    "YTT", # flake8-2020
]
ignore = [
    "C408",   # Unnecessary {obj_type} call (rewrite as a literal)
    "B905",   # zip() without an explicit strict= parameter
    "C901",   # {name} is too complex ({complexity} > {max_complexity})
    "COM812",
    # "CPY001", # Missing copyright notice at top of file
    "D100",    # Missing docstring in public module
    "D101",    # Missing docstring in public class
    "D102",    # Missing docstring in public method
    "D103",    # Missing docstring in public function
    "D104",    # Missing docstring in public package
    "D105",    # Missing docstring in magic method
    "D106",    # Missing docstring in public nested class
    "D107",    # Missing docstring in __init__
    "D203",    # 1 blank line required before class docstring
    "D204",    # 1 blank line required after class docstring
    "D213",    # Multi-line docstring summary should start at the second line
    "D215",    # Section underline is over-indented ("{name}")
    "D400",    # First line should end with a period
    "D401",    # First line of docstring should be in imperative mood: "{first_line}"
    "D404",    # First word of the docstring should not be "This"
    "D406",    # Section name should end with a newline ("{name}")
    "D407",    # Missing dashed underline after section ("{name}")
    "D408",    # Section underline should be in the line following the section's name ("{name}")
    "D409",    # Section underline should match the length of its name ("{name}")
    "D413",    # Missing blank line after last section ("{name}")
    "ISC001",
    "PLR0912", # Too many branches
    "PLR0913", # Too many arguments to function call
    "PLR0915", # Too many statements
    # "PLR2004", # Magic values instead of named consts
    "SLF001", # Private member accessed
    "TRY003", # Avoid specifying long messages outside the exception class
]

[tool.ruff.lint.flake8-quotes]
docstring-quotes = "double"

[tool.ruff.format]
# Enable preview style formatting.
preview = true

[tool.ruff.lint.isort]
lines-after-imports = 2
# lines-between-types = 1
# atomic = true
force-sort-within-sections = true
combine-as-imports = true

[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["E402", "I001"]
"scripts/*" = ["INP001"]

[tool.pyright]
venvPath = "."
venv = ".venv"
pythonVersion = "3.12"
pythonPlatform = "All"
typeCheckingMode = "basic"
deprecateTypingAliases = true
reportMissingTypeStubs = false
reportUnusedCallResult = false
reportUnknownVariableType = false
reportAny = false
reportImplicitOverride = false
reportUnusedFunction = false
reportImplicitStringConcatenation = false
reportIgnoreCommentWithoutRule = false
reportUnannotatedClassAttribute = false
reportSelfClsParameterName = false
reportPrivateImportUsage = false
reportUnusedExpression = false

[tool.mknodes]
allowed-commit-types = [
    "fix",
    "feat",
    "refactor",
    "docs",
    "test",
    "build",
    "chore",
]
docstring-style = "google"