pyproject.toml

[project]
name = "sentient"
version = "3.0.0a0"
description = "Sentient - a local-first, configurable, self-evolving personal assistant"
readme = "README.md"
requires-python = ">=3.12"
license = { text = "AGPL-3.0-only" }
authors = [{ name = "Existence" }]
dependencies = [
    # core daemon
    "fastapi>=0.142.2",
    "uvicorn[standard]>=0.54.0",
    "pydantic>=2.13.5",
    "pydantic-settings>=2.15.0",
    "pyyaml>=6.0.3",
    "httpx>=0.28.1",
    # llm providers (one SDK, every provider, native tool calling)
    "litellm>=1.104.0",
    # storage: one sqlite file, vectors + full-text search inside it
    "aiosqlite>=0.22.1",
    "sqlite-vec>=0.1.9",
    # secrets live in the OS keychain, never in config files
    "keyring>=25.7.0",
    # cli
    "typer>=0.27.2",
    "rich>=15.0.0",
    # scheduling helpers (rrule)
    "python-dateutil>=2.9.0.post0",
    # IANA timezone database (Windows has none built in)
    "tzdata>=2026.5",
    "tzlocal>=5.4.4",
    # last-resort repair of malformed JSON from small local models
    "json-repair>=0.63.5",
    # file uploads in the gateway
    "python-multipart>=0.0.32",
    # integrations: external MCP servers, keyless web search, news feeds
    "mcp>=2.3.0",
    "ddgs>=9.16.0",
    "feedparser>=6.0.14",
    # text extraction for attachments and memory import
    "pypdf>=6.19.0",
    "python-docx>=1.2.0",
    # browser control, IMAP push, device TLS + discovery, pairing QR codes
    "playwright>=1.63.0",
    "aioimaplib>=2.0.1",
    "cryptography>=50.0.2",
    "zeroconf>=0.151.5",
    "segno>=1.6.6",
    # local vision models through Ollama: LiteLLM converts images with Pillow
    "pillow>=12.3.0",
]

[project.optional-dependencies]
voice = [
    "numpy>=2.5.3",
    "soundfile>=0.14.0",
    "faster-whisper>=1.2.1",
    "pyttsx3>=2.99",
    "kokoro-onnx>=0.6.1",
    # openWakeWord pulls tflite-runtime on Linux, which has no Python 3.12 wheels; Linux uses the default
    # Whisper wake engine instead (Sentient runs openWakeWord through ONNX where it is installed).
    "openwakeword>=0.6; sys_platform != 'linux'",
]
# optional: webcam for the reference device node (sentient node --camera 0)
node = [
    "opencv-python-headless>=5.0.0.93",
]
# optional: WhatsApp as a messaging channel (a linked device on your own account, ADR 0020).
# neonize wraps whatsmeow and ships it as a shared library in its wheel: nothing else to install.
whatsapp = [
    "neonize>=0.5.2",
]
# optional: run faster-whisper on an NVIDIA GPU without a system CUDA install
voice-gpu = [
    "nvidia-cublas-cu12>=12.9.2.10",
    "nvidia-cudnn-cu12>=9.27.0.42",
]
dev = [
    "pytest>=9.1.1",
    "pytest-asyncio>=1.4.0",
    "ruff>=0.16.10",
    "respx>=0.23.1",
    "pytest-timeout>=2.4.0",
    # packaging: freezes the engine for the installer (packaging/build_engine.py)
    "pyinstaller>=6.22.3",
]

[project.scripts]
sentient = "sentient.cli:app"

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

[tool.hatch.build.targets.wheel]
packages = ["sentient"]

[tool.pytest.ini_options]
asyncio_mode = "auto"
testpaths = ["tests"]

[tool.ruff]
line-length = 100
target-version = "py312"
extend-exclude = ["src", "venv"]

[tool.ruff.lint]
# Explicit ruleset so results do not depend on a developer's global ruff config.
select = ["E", "F", "I", "UP", "B", "RUF", "SIM", "TRY", "DTZ", "RET"]
ignore = [
    "E501",    # line length: handled by the formatter
    "RUF012",  # ToolPlugin class attributes are intentionally mutable declarations
    "B008",    # typer.Option() in defaults is the documented typer style
    "DTZ011",  # date.today() for daily-note file names is intentionally local
    "TRY003",  # long exception messages are fine
    "TRY300",  # return-in-try is readable here
    "TRY400",  # log.warning in fallback paths is deliberate (not always an error)
]