nyxGPT 2.1.0__tar.gz

nyxgpt-2.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Darla Baker (dkblinux98)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nyxgpt-2.1.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: nyxGPT
+Version: 2.1.0
+Summary: Local ChatGPT-style system
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.27
+Requires-Dist: cassandra-driver>=3.29.2
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: markdown>=3.5
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: pypdf>=3.17
+Requires-Dist: pdfplumber>=0.11.0
+Requires-Dist: python-docx>=1.0.0
+Requires-Dist: python-pptx>=0.6.23
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: ebooklib>=0.18
+Requires-Dist: pytesseract>=0.3.10
+Requires-Dist: pdf2image>=1.16.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: prometheus-client>=0.20.0
+Requires-Dist: opentelemetry-api>=1.24.0
+Requires-Dist: opentelemetry-sdk>=1.24.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.24.0
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.45b0
+Requires-Dist: opentelemetry-instrumentation-cassandra>=0.45b0
+Requires-Dist: opentelemetry-instrumentation-urllib>=0.45b0
+Requires-Dist: sentry-sdk>=2.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: types-Markdown; extra == "dev"
+Requires-Dist: types-psutil; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: yamllint>=1.35; extra == "dev"
+Requires-Dist: interrogate>=1.7; extra == "dev"
+Requires-Dist: bandit[toml]>=1.7; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Requires-Dist: pre-commit>=3.6; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+Requires-Dist: reportlab>=4.0; extra == "dev"
+Dynamic: license-file
+
+# nyxGPT
+
+**nyxGPT** is a local-first, private, extensible ChatGPT-style system designed to run entirely on your own machine.
+
+It uses **Ollama** for local LLM inference, supports persistent **conversation sessions**, optional **Retrieval‑Augmented Generation (RAG)** backed by **Apache Cassandra**, a powerful **CLI**, a **FastAPI backend**, and a lightweight **local web UI** built with Next.js.
+
+Your data stays on your machine. No cloud dependency is required.
+
+---
+
+## Installing 2.1.0 from PyPI — read this first
+
+The `nyxgpt` package on PyPI provides the Python package (CLI, API, core)
+as a versioned artifact, **but version 2.1.0 is not yet self-contained**:
+the stack-lifecycle tooling (`nyxgpt ops install` and friends) resolves its
+runtime resources relative to a source checkout. A bare `pip install nyxgpt`
+on a clean machine will import and run, but **full stack operation requires
+cloning this repository** and installing from it:
+
+```bash
+git clone https://github.com/dkblinux98/nyxGPT.git
+cd nyxGPT
+pip install -e .
+nyxgpt ops install
+```
+
+Repo-less, artifact-only installation is planned for a later release
+(tracked in #3621/#3622).
+
+---
+
+## Why nyxGPT?
+
+- Local‑only by default (no cloud calls)
+- Your prompts, sessions, and embeddings never leave your machine
+- Clear separation between CLI, API, UI, and core logic
+- Designed for experimentation, learning, and extension
+- Production‑like ops tooling for a local system
+
+---
+
+## Key features
+
+- Local LLM inference via **Ollama**
+- Persistent sessions stored outside the repository
+- **Message editing and regeneration** - Edit messages and fork conversations, regenerate responses
+- **Message search** - Full-text search across all sessions with filters for role, session, and case-sensitivity
+- **Automatic session naming** with LLM‑generated titles and smart filename sync
+- **Session management** with right-click context menus, rename, export, delete, and pin
+- Optional **RAG** using Cassandra 5.0 native vector search
+- **Per‑session RAG controls** via WebUI and API
+- Config‑driven RAG context pruning and prompt optimization
+- **Optimized embedding generation** with async processing, GPU utilization, and adaptive batching
+- Streaming responses (CLI, API, Web UI)
+- Unified core shared between CLI and FastAPI
+- Optional **API rate limiting** (disabled by default for localhost use)
+- Homebrew‑managed background services
+- Optional **Kubernetes deployment** for local clusters (kind/minikube/k3s)
+- **Local canary deployment** — deploy a versioned build to canary only, gate a gradual weighted rollout on live metrics, then promote it to stable (or roll back) — operable from the SRE/admin dashboard (`nyxgpt canary` CLI or `/admin/canary`)
+- **System health dashboard** — service uptime, dependency reachability checks (Ollama, Cassandra), resource utilization, and alert indicators live from Grafana's real alerting (falling back to a labeled local estimate if Grafana is unreachable), surfaced in the SRE/admin dashboard (`/admin/health`)
+- **Prometheus metrics** (`/metrics`) — request counts, latency histograms, error rates, and chat/RAG business metrics, surfaced in the SRE/admin dashboard (`/admin`)
+- **Monitoring dashboards** (Grafana) — local-only system overview, RAG performance (including ingest activity), API metrics, resource usage (CPU/mem/disk/queue/cache/rate-limit), and self-healing dashboards backed by Prometheus, plus real alerting (CPU/memory/disk/service-down/self-heal/canary rules, a Slack contact point, `nyxgpt ops alert-test` — see [docs/alerting.md](docs/alerting.md)), auto-started with `nyxgpt ops install` (`nyxgpt ops observability` to start/re-run standalone), linked from the SRE/admin dashboard (`/admin`)
+- **Log aggregation** (Loki + promtail) — local-only centralized search over `~/.nyxGPT/logs` (api, web, Ollama, Cassandra — Ollama captured automatically by `nyxgpt ops install` whether it's running natively or as a Compose container) with a retention policy, searched via Grafana's Logs Drilldown app and a featured queryless logs panel (`{job="nyxgpt"}`) on the SRE Home dashboard, auto-started with `nyxgpt ops install`
+- **Distributed tracing** (OpenTelemetry) — local-only request/RAG/Ollama/Cassandra spans exported to a local Jaeger instance and browsed inside Grafana via a Jaeger datasource, auto-started with `nyxgpt ops install`
+- **Error tracking** (self-hosted GlitchTip) — local-only backend exception and web UI client error reporting via the Sentry SDK protocol, auto-started and auto-provisioned (admin user, org, project, DSN, and a Grafana API token) with `nyxgpt ops install` — zero-touch, no manual sign-in step — surfaced as Grafana panels via the Infinity datasource
+- **SRE Overview** — Grafana is the single pane of glass: the Admin Dashboard's SRE Overview tile (`/admin/dashboard`) opens Grafana's SRE Home dashboard in a new tab, reaching every Grafana dashboard, Logs Drilldown, traces, and GlitchTip error tracking above, all provisioned as code
+- Optional **Docker Compose** stack for one-command bring-up of every component
+- Robust unit and integration test suite
+
+---
+
+## Quick start
+
+### Requirements
+
+- Python 3.11+
+- Ollama
+- Homebrew
+- Docker Desktop (required for Cassandra / RAG)
+- Node.js (for the local web UI)
+
+### Install and configure
+
+```bash
+pip install -e .
+nyxgpt wizard        # interactive setup: Ollama connection, default model, RAG, config.ini
+```
+
+The wizard tests your Ollama connection, helps you pick a default model,
+optionally configures RAG, and generates `~/.nyxGPT/config.ini` — all
+runtime configuration lives outside the repository. See
+[Configuration](docs/configuration.md) for every `config.ini` section and
+key, and [CLI](docs/cli.md) for the full command reference.
+
+### Start services
+
+```bash
+nyxgpt ops install    # installs and starts API, web UI, Cassandra helpers, observability
+nyxgpt ops doctor      # verify everything is healthy
+```
+
+Then chat from the CLI or the [local web UI](docs/ui.md#local-web-ui-nextjs)
+(`http://127.0.0.1:3000`, started by `nyxgpt ops install` or
+`nyxgpt ops restart web`):
+
+```bash
+nyxgpt chat "Hello"
+```
+
+`nyxgpt ops` also covers restarting, stopping, and tearing down every
+component — see [Ops helpers](docs/ops.md). Alternative deployment paths
+(a single-command containerized stack, a local Kubernetes cluster with
+canary rollout, or Terraform-managed local infrastructure)
+are documented in [Docker Compose](docs/docker-compose.md),
+[Kubernetes](docs/kubernetes.md), and [Terraform](docs/terraform.md) —
+each is driven through `nyxgpt`-wrapped commands, never a raw
+`docker`/`docker compose`/`kubectl`/`terraform` invocation.
+
+---
+
+## Logs & runtime data
+
+All runtime state lives under:
+
+```text
+~/.nyxGPT/
+```
+
+Including:
+
+- `sessions/` – conversation sessions
+- `logs/` – API, web UI, Ollama, and Cassandra logs
+- `scripts/` – service wrapper scripts
+
+No runtime data is stored in the git repository.
+
+---
+
+## Documentation
+
+Full documentation lives under [`docs/`](docs/README.md) — see the
+**[documentation index](docs/README.md)** for the complete, grouped list
+(User guides · Operations & deployment · Developer · Agent system).
+
+Common starting points:
+
+- **Configuration** – [`docs/configuration.md`](docs/configuration.md)
+- **CLI** – [`docs/cli.md`](docs/cli.md)
+- **API** – [`docs/api.md`](docs/api.md)
+- **UI (Web)** – [`docs/ui.md`](docs/ui.md)
+- **RAG** – [`docs/rag.md`](docs/rag.md)
+- **Sessions & Memory** – [`docs/sessions.md`](docs/sessions.md)
+- **Docker Compose** – [`docs/docker-compose.md`](docs/docker-compose.md)
+- **Self-healing** – [`docs/self-healing.md`](docs/self-healing.md)
+- **Security** – [`docs/security.md`](docs/security.md)
+- **Architecture** – [`docs/architecture.md`](docs/architecture.md)
+- **Troubleshooting** – [`docs/troubleshooting.md`](docs/troubleshooting.md)
+
+If you are new to the project, start with **configuration**, then **architecture**, then **api**.
+
+---
+
+## GitHub Automation
+
+This repository is developed by an automated agent loop (scrummaster →
+developer → review) plus an on-demand `@claude` mention workflow, and ships
+several Claude Code automations (MCP servers, hooks, a subagent, a skill)
+that activate automatically in this directory. See
+[docs/development.md](docs/development.md) for the full workflow reference
+and [AGENTS.md](AGENTS.md) for agent roles and permissions.
+
+---
+
+## Project notes
+
+- Distribution name: **nyxGPT**
+- Python package name: **nyxgpt**
+- Runtime data is always externalized
+- Build artifacts such as `*.egg-info/` must not be committed
+
+---
+
+## Status
+
+The core architecture, ops tooling, streaming, web UI, and RAG foundations are complete.
+
+Future work focuses on:
+- UX refinement
+- performance tuning
+- richer session metadata and search
+- optional multi‑user and auth extensions
+
+---
+
+## License
+
+nyxGPT is released under the [MIT License](LICENSE).

nyxgpt-2.1.0/README.md

@@ -0,0 +1,197 @@
+# nyxGPT
+
+**nyxGPT** is a local-first, private, extensible ChatGPT-style system designed to run entirely on your own machine.
+
+It uses **Ollama** for local LLM inference, supports persistent **conversation sessions**, optional **Retrieval‑Augmented Generation (RAG)** backed by **Apache Cassandra**, a powerful **CLI**, a **FastAPI backend**, and a lightweight **local web UI** built with Next.js.
+
+Your data stays on your machine. No cloud dependency is required.
+
+---
+
+## Installing 2.1.0 from PyPI — read this first
+
+The `nyxgpt` package on PyPI provides the Python package (CLI, API, core)
+as a versioned artifact, **but version 2.1.0 is not yet self-contained**:
+the stack-lifecycle tooling (`nyxgpt ops install` and friends) resolves its
+runtime resources relative to a source checkout. A bare `pip install nyxgpt`
+on a clean machine will import and run, but **full stack operation requires
+cloning this repository** and installing from it:
+
+```bash
+git clone https://github.com/dkblinux98/nyxGPT.git
+cd nyxGPT
+pip install -e .
+nyxgpt ops install
+```
+
+Repo-less, artifact-only installation is planned for a later release
+(tracked in #3621/#3622).
+
+---
+
+## Why nyxGPT?
+
+- Local‑only by default (no cloud calls)
+- Your prompts, sessions, and embeddings never leave your machine
+- Clear separation between CLI, API, UI, and core logic
+- Designed for experimentation, learning, and extension
+- Production‑like ops tooling for a local system
+
+---
+
+## Key features
+
+- Local LLM inference via **Ollama**
+- Persistent sessions stored outside the repository
+- **Message editing and regeneration** - Edit messages and fork conversations, regenerate responses
+- **Message search** - Full-text search across all sessions with filters for role, session, and case-sensitivity
+- **Automatic session naming** with LLM‑generated titles and smart filename sync
+- **Session management** with right-click context menus, rename, export, delete, and pin
+- Optional **RAG** using Cassandra 5.0 native vector search
+- **Per‑session RAG controls** via WebUI and API
+- Config‑driven RAG context pruning and prompt optimization
+- **Optimized embedding generation** with async processing, GPU utilization, and adaptive batching
+- Streaming responses (CLI, API, Web UI)
+- Unified core shared between CLI and FastAPI
+- Optional **API rate limiting** (disabled by default for localhost use)
+- Homebrew‑managed background services
+- Optional **Kubernetes deployment** for local clusters (kind/minikube/k3s)
+- **Local canary deployment** — deploy a versioned build to canary only, gate a gradual weighted rollout on live metrics, then promote it to stable (or roll back) — operable from the SRE/admin dashboard (`nyxgpt canary` CLI or `/admin/canary`)
+- **System health dashboard** — service uptime, dependency reachability checks (Ollama, Cassandra), resource utilization, and alert indicators live from Grafana's real alerting (falling back to a labeled local estimate if Grafana is unreachable), surfaced in the SRE/admin dashboard (`/admin/health`)
+- **Prometheus metrics** (`/metrics`) — request counts, latency histograms, error rates, and chat/RAG business metrics, surfaced in the SRE/admin dashboard (`/admin`)
+- **Monitoring dashboards** (Grafana) — local-only system overview, RAG performance (including ingest activity), API metrics, resource usage (CPU/mem/disk/queue/cache/rate-limit), and self-healing dashboards backed by Prometheus, plus real alerting (CPU/memory/disk/service-down/self-heal/canary rules, a Slack contact point, `nyxgpt ops alert-test` — see [docs/alerting.md](docs/alerting.md)), auto-started with `nyxgpt ops install` (`nyxgpt ops observability` to start/re-run standalone), linked from the SRE/admin dashboard (`/admin`)
+- **Log aggregation** (Loki + promtail) — local-only centralized search over `~/.nyxGPT/logs` (api, web, Ollama, Cassandra — Ollama captured automatically by `nyxgpt ops install` whether it's running natively or as a Compose container) with a retention policy, searched via Grafana's Logs Drilldown app and a featured queryless logs panel (`{job="nyxgpt"}`) on the SRE Home dashboard, auto-started with `nyxgpt ops install`
+- **Distributed tracing** (OpenTelemetry) — local-only request/RAG/Ollama/Cassandra spans exported to a local Jaeger instance and browsed inside Grafana via a Jaeger datasource, auto-started with `nyxgpt ops install`
+- **Error tracking** (self-hosted GlitchTip) — local-only backend exception and web UI client error reporting via the Sentry SDK protocol, auto-started and auto-provisioned (admin user, org, project, DSN, and a Grafana API token) with `nyxgpt ops install` — zero-touch, no manual sign-in step — surfaced as Grafana panels via the Infinity datasource
+- **SRE Overview** — Grafana is the single pane of glass: the Admin Dashboard's SRE Overview tile (`/admin/dashboard`) opens Grafana's SRE Home dashboard in a new tab, reaching every Grafana dashboard, Logs Drilldown, traces, and GlitchTip error tracking above, all provisioned as code
+- Optional **Docker Compose** stack for one-command bring-up of every component
+- Robust unit and integration test suite
+
+---
+
+## Quick start
+
+### Requirements
+
+- Python 3.11+
+- Ollama
+- Homebrew
+- Docker Desktop (required for Cassandra / RAG)
+- Node.js (for the local web UI)
+
+### Install and configure
+
+```bash
+pip install -e .
+nyxgpt wizard        # interactive setup: Ollama connection, default model, RAG, config.ini
+```
+
+The wizard tests your Ollama connection, helps you pick a default model,
+optionally configures RAG, and generates `~/.nyxGPT/config.ini` — all
+runtime configuration lives outside the repository. See
+[Configuration](docs/configuration.md) for every `config.ini` section and
+key, and [CLI](docs/cli.md) for the full command reference.
+
+### Start services
+
+```bash
+nyxgpt ops install    # installs and starts API, web UI, Cassandra helpers, observability
+nyxgpt ops doctor      # verify everything is healthy
+```
+
+Then chat from the CLI or the [local web UI](docs/ui.md#local-web-ui-nextjs)
+(`http://127.0.0.1:3000`, started by `nyxgpt ops install` or
+`nyxgpt ops restart web`):
+
+```bash
+nyxgpt chat "Hello"
+```
+
+`nyxgpt ops` also covers restarting, stopping, and tearing down every
+component — see [Ops helpers](docs/ops.md). Alternative deployment paths
+(a single-command containerized stack, a local Kubernetes cluster with
+canary rollout, or Terraform-managed local infrastructure)
+are documented in [Docker Compose](docs/docker-compose.md),
+[Kubernetes](docs/kubernetes.md), and [Terraform](docs/terraform.md) —
+each is driven through `nyxgpt`-wrapped commands, never a raw
+`docker`/`docker compose`/`kubectl`/`terraform` invocation.
+
+---
+
+## Logs & runtime data
+
+All runtime state lives under:
+
+```text
+~/.nyxGPT/
+```
+
+Including:
+
+- `sessions/` – conversation sessions
+- `logs/` – API, web UI, Ollama, and Cassandra logs
+- `scripts/` – service wrapper scripts
+
+No runtime data is stored in the git repository.
+
+---
+
+## Documentation
+
+Full documentation lives under [`docs/`](docs/README.md) — see the
+**[documentation index](docs/README.md)** for the complete, grouped list
+(User guides · Operations & deployment · Developer · Agent system).
+
+Common starting points:
+
+- **Configuration** – [`docs/configuration.md`](docs/configuration.md)
+- **CLI** – [`docs/cli.md`](docs/cli.md)
+- **API** – [`docs/api.md`](docs/api.md)
+- **UI (Web)** – [`docs/ui.md`](docs/ui.md)
+- **RAG** – [`docs/rag.md`](docs/rag.md)
+- **Sessions & Memory** – [`docs/sessions.md`](docs/sessions.md)
+- **Docker Compose** – [`docs/docker-compose.md`](docs/docker-compose.md)
+- **Self-healing** – [`docs/self-healing.md`](docs/self-healing.md)
+- **Security** – [`docs/security.md`](docs/security.md)
+- **Architecture** – [`docs/architecture.md`](docs/architecture.md)
+- **Troubleshooting** – [`docs/troubleshooting.md`](docs/troubleshooting.md)
+
+If you are new to the project, start with **configuration**, then **architecture**, then **api**.
+
+---
+
+## GitHub Automation
+
+This repository is developed by an automated agent loop (scrummaster →
+developer → review) plus an on-demand `@claude` mention workflow, and ships
+several Claude Code automations (MCP servers, hooks, a subagent, a skill)
+that activate automatically in this directory. See
+[docs/development.md](docs/development.md) for the full workflow reference
+and [AGENTS.md](AGENTS.md) for agent roles and permissions.
+
+---
+
+## Project notes
+
+- Distribution name: **nyxGPT**
+- Python package name: **nyxgpt**
+- Runtime data is always externalized
+- Build artifacts such as `*.egg-info/` must not be committed
+
+---
+
+## Status
+
+The core architecture, ops tooling, streaming, web UI, and RAG foundations are complete.
+
+Future work focuses on:
+- UX refinement
+- performance tuning
+- richer session metadata and search
+- optional multi‑user and auth extensions
+
+---
+
+## License
+
+nyxGPT is released under the [MIT License](LICENSE).

nyxgpt-2.1.0/pyproject.toml

@@ -0,0 +1,189 @@
+[project]
+name = "nyxGPT"
+version = "2.1.0"
+description = "Local ChatGPT-style system"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "fastapi>=0.110",
+  "uvicorn>=0.27",
+  "cassandra-driver>=3.29.2",
+  "python-frontmatter>=1.0.0",
+  "markdown>=3.5",
+  "beautifulsoup4>=4.12",
+  "pypdf>=3.17",
+  "pdfplumber>=0.11.0",
+  "python-docx>=1.0.0",
+  "python-pptx>=0.6.23",
+  "python-multipart>=0.0.6",
+  "tiktoken>=0.5.0",
+  "ebooklib>=0.18",
+  "pytesseract>=0.3.10",
+  "pdf2image>=1.16.0",
+  "pillow>=10.0.0",
+  "psutil>=5.9.0",
+  "prometheus-client>=0.20.0",
+  "opentelemetry-api>=1.24.0",
+  "opentelemetry-sdk>=1.24.0",
+  "opentelemetry-exporter-otlp-proto-http>=1.24.0",
+  "opentelemetry-instrumentation-fastapi>=0.45b0",
+  "opentelemetry-instrumentation-cassandra>=0.45b0",
+  # Instruments urllib.request (ollama_client.py's HTTP client) so outbound
+  # Ollama calls get a client span plus automatic W3C traceparent header
+  # injection -- the "no hand-rolled header forwarding" correlation backbone
+  # requirement (#3430).
+  "opentelemetry-instrumentation-urllib>=0.45b0",
+  "sentry-sdk>=2.0",
+  # ops.py imports httpx unconditionally (GlitchTip HTTP client) and the api
+  # imports ops.py, so httpx is a core runtime dep -- not just a ui/dev extra.
+  "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = [
+  # Testing
+  "pytest>=8.0",
+  "pytest-cov>=5.0",
+  "pytest-mock>=3.12",
+  "pytest-asyncio>=0.23",
+
+  # Type checking
+  "mypy>=1.8",
+  "types-Markdown",
+  "types-psutil",
+
+  # Linting & formatting
+  "ruff>=0.1",
+  "black>=24.0",
+  "yamllint>=1.35",
+  "interrogate>=1.7",
+
+  # Security scanning (#3501)
+  "bandit[toml]>=1.7",
+  "pip-audit>=2.7",
+
+  # Pre-commit hooks
+  "pre-commit>=3.6",
+
+  # Development tools
+  "httpx>=0.27",
+  "reportlab>=4.0",
+]
+
+[project.scripts]
+nyxgpt = "nyxgpt.cli:cli"
+
+# By default, run all tests. Use -m unit or -m integration to filter.
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = "-v"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+markers = [
+  "unit: fast unit tests with no external dependencies",
+  "integration: tests requiring external services (Ollama/Cassandra/Docker)",
+  "all: alias marker for running the full test suite",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = false
+disallow_untyped_decorators = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+show_error_codes = true
+
+# Ignore missing imports for third-party libraries without stubs
+[[tool.mypy.overrides]]
+module = [
+    "frontmatter",
+    "cassandra.*",
+    "pdfplumber",
+    "reportlab.*",
+    "docx.*",
+    "pptx.*",
+    "ebooklib.*",
+    "pytesseract",
+    "pdf2image",
+    "PIL.*",
+    "fastapi",
+    "fastapi.*",
+    "starlette.*",
+    "pydantic",
+    "pydantic.*",
+    "bs4",
+    "pypdf",
+    "httpx",
+    "tiktoken",
+    "psutil",
+    "markdown",
+    "opentelemetry.*",
+]
+ignore_missing_imports = true
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+]
+ignore = [
+    "E501",  # line too long (handled by black)
+    "B008",  # do not perform function calls in argument defaults
+    "C901",  # too complex
+]
+
+[tool.ruff.per-file-ignores]
+"__init__.py" = ["F401"]
+"tests/**/*.py" = ["ARG"]
+
+[tool.ruff.isort]
+known-first-party = ["nyxgpt"]
+
+[tool.interrogate]
+# Docstring-coverage gate (issue #3225). Nested/closure functions and classes
+# (e.g. retry-callback closures) are exempt as trivial implementation
+# details of an already-documented enclosing function.
+ignore-nested-functions = true
+ignore-nested-classes = true
+fail-under = 100
+verbose = 1
+exclude = ["tests"]
+
+[tool.black]
+line-length = 100
+target-version = ["py311"]
+include = '\.pyi?$'
+
+[tool.bandit]
+# SAST scan of runtime code only -- tests intentionally exercise things
+# bandit flags out of context (e.g. hardcoded test fixtures, subprocess
+# calls against local test services). See security/README.md for the CI
+# gate (severity/confidence thresholds) and suppression conventions (#3501).
+exclude_dirs = ["tests", ".venv", "venv", "web"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"

nyxgpt-2.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+