chaoscypher-cli 0.1.0__tar.gz

chaoscypher_cli-0.1.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: chaoscypher-cli
+Version: 0.1.0
+Summary: Command-line tools for Chaos Cypher knowledge graph library
+Author-email: Denis MacPherson <denis@chaoscypher.com>
+Maintainer-email: Denis MacPherson <denis@chaoscypher.com>
+License-Expression: AGPL-3.0-only
+Project-URL: Homepage, https://github.com/chaoscypherinc/chaoscypher
+Project-URL: Documentation, https://github.com/chaoscypherinc/chaoscypher#readme
+Project-URL: Repository, https://github.com/chaoscypherinc/chaoscypher
+Project-URL: Issues, https://github.com/chaoscypherinc/chaoscypher/issues
+Keywords: knowledge-graph,cli,command-line,chaoscypher
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: chaoscypher-core>=0.1.0
+Requires-Dist: click<9,>=8.3.0
+Requires-Dist: rich<16,>=15.0.0
+Requires-Dist: platformdirs<5,>=4.9.0
+Requires-Dist: pyyaml<7,>=6.0.3
+Requires-Dist: structlog<26,>=25.5.0
+Requires-Dist: mcp<2,>=1.27.0
+Requires-Dist: httpx<1,>=0.28.0
+Provides-Extra: server
+Requires-Dist: uvicorn<1,>=0.44.0; extra == "server"
+Requires-Dist: fastapi<1,>=0.135.0; extra == "server"
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=9.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio<2,>=1.2.0; extra == "dev"
+Requires-Dist: pytest-cov<8,>=7.1.0; extra == "dev"
+Requires-Dist: ruff<1,>=0.15.0; extra == "dev"
+Requires-Dist: mypy<2,>=1.20.0; extra == "dev"
+
+# ChaosCypher CLI
+
+Command-line tools for ChaosCypher knowledge graph library.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pipx install chaoscypher-cli
+```
+
+> **Note:** If `pipx install chaoscypher-cli` fails with "No matching distribution found", the package has not been published to PyPI yet — install [from source](#from-source) below. The CLI also requires Python 3.14+, so pipx must run on a 3.14 interpreter.
+
+[pipx](https://pipx.pypa.io/) installs the CLI in an isolated environment and automatically adds it to your PATH. If you don't have pipx, install it first:
+
+```bash
+# macOS
+brew install pipx
+
+# Linux (Debian/Ubuntu)
+sudo apt install pipx
+
+# Windows
+scoop install pipx
+```
+
+### From source
+
+```bash
+git clone https://github.com/chaoscypherinc/chaoscypher.git
+cd chaoscypher
+# Install uv first: https://docs.astral.sh/uv/getting-started/installation/
+uv sync --package chaoscypher-cli
+```
+
+> **Note:** On Windows, the `chaoscypher` command lands in `.venv\Scripts\` after `uv sync`. Run it via `uv run chaoscypher` from the repo root, or activate the venv (`.venv\Scripts\activate`) for a bare `chaoscypher` invocation.
+
+### Development install
+
+```bash
+git clone https://github.com/chaoscypherinc/chaoscypher.git
+cd chaoscypher
+uv sync --all-packages --extra dev   # full workspace + dev tools
+```
+
+## Usage
+
+```bash
+# Show help
+chaoscypher --help
+
+# Create a new database
+chaoscypher db create my-graph
+
+# Add source documents
+chaoscypher source add documents/
+
+# Add with explicit upload-time options (API parity with POST /sources)
+chaoscypher source add paper.pdf \
+    --vision \
+    --content-filtering \
+    --normalize \
+    --filtering-mode strict \
+    --skip-duplicates
+
+# Export knowledge graph
+chaoscypher graph package export --output my-knowledge.ccx
+
+# Import knowledge graph
+chaoscypher graph package load my-knowledge.ccx
+
+# Search the graph
+chaoscypher source search "artificial intelligence"
+```
+
+### Upload-time flags (API parity)
+
+`source add` exposes the same upload-time choices the API does. Each flag persists on the source row and is preserved across recovery / retry / re-extract.
+
+| Flag | Default | API equivalent |
+|---|---|---|
+| `--vision/--no-vision` | `--vision` | `enable_vision` |
+| `--content-filtering/--no-content-filtering` | `--content-filtering` | `content_filtering` |
+| `--normalize/--no-normalize` | (file-type default — on for prose, off for CSV/JSON/XML) | `enable_normalization` |
+| `--filtering-mode {maximum,strict,balanced,lenient,minimal,unfiltered}` | unset (resolves to `balanced`) | `filtering_mode` |
+| `--skip-duplicates` | off | `skip_duplicates` |
+
+Run `chaoscypher source add --help` for the full flag list.
+
+## Features
+
+- **Graph Management**: Create, delete, and manage knowledge graphs
+- **Data Import**: Import documents (PDF, DOCX, TXT, CSV, JSON, audio, archives)
+- **Data Export**: Export graphs as `.ccx` packages (CCX — Chaos Cypher eXchange)
+- **Search**: Full-text and vector search across the knowledge graph
+- **Chat**: Interactive AI chat with graph-grounded RAG
+- **Quality**: Run extraction quality scoring and reports
+- **Benchmark**: Run reproducible extraction benchmarks across models
+
+## Development
+
+```bash
+# Run tests
+uv run pytest
+
+# Format code (ruff replaces black; ruff format is the formatter)
+uv run ruff format chaoscypher_cli/
+uv run ruff check chaoscypher_cli/
+
+# Type checking
+mypy chaoscypher_cli/
+```
+
+## Architecture
+
+The CLI is a thin wrapper around the `chaoscypher` core library, providing:
+- User-friendly command-line interface using Click
+- Rich terminal output with progress bars and formatting
+- Configuration management via the unified `settings.yaml` and `CHAOSCYPHER_*` environment variables (managed with `chaoscypher config show/get/set/edit`)
+- Batch operations and scripting support
+
+## Requirements
+
+- Python 3.14+
+- chaoscypher-core>=0.1.0
+
+## License
+
+AGPL-3.0 License - see LICENSE file for details.
+
+## Links
+
+- [ChaosCypher Core Library](https://github.com/chaoscypherinc/chaoscypher)
+- [ChaosCypher Docker App](https://github.com/chaoscypherinc/chaoscypher)
+- [ChaosCypher monorepo](https://github.com/chaoscypherinc/chaoscypher)

chaoscypher_cli-0.1.0/README.md

@@ -0,0 +1,136 @@
+# ChaosCypher CLI
+
+Command-line tools for ChaosCypher knowledge graph library.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pipx install chaoscypher-cli
+```
+
+> **Note:** If `pipx install chaoscypher-cli` fails with "No matching distribution found", the package has not been published to PyPI yet — install [from source](#from-source) below. The CLI also requires Python 3.14+, so pipx must run on a 3.14 interpreter.
+
+[pipx](https://pipx.pypa.io/) installs the CLI in an isolated environment and automatically adds it to your PATH. If you don't have pipx, install it first:
+
+```bash
+# macOS
+brew install pipx
+
+# Linux (Debian/Ubuntu)
+sudo apt install pipx
+
+# Windows
+scoop install pipx
+```
+
+### From source
+
+```bash
+git clone https://github.com/chaoscypherinc/chaoscypher.git
+cd chaoscypher
+# Install uv first: https://docs.astral.sh/uv/getting-started/installation/
+uv sync --package chaoscypher-cli
+```
+
+> **Note:** On Windows, the `chaoscypher` command lands in `.venv\Scripts\` after `uv sync`. Run it via `uv run chaoscypher` from the repo root, or activate the venv (`.venv\Scripts\activate`) for a bare `chaoscypher` invocation.
+
+### Development install
+
+```bash
+git clone https://github.com/chaoscypherinc/chaoscypher.git
+cd chaoscypher
+uv sync --all-packages --extra dev   # full workspace + dev tools
+```
+
+## Usage
+
+```bash
+# Show help
+chaoscypher --help
+
+# Create a new database
+chaoscypher db create my-graph
+
+# Add source documents
+chaoscypher source add documents/
+
+# Add with explicit upload-time options (API parity with POST /sources)
+chaoscypher source add paper.pdf \
+    --vision \
+    --content-filtering \
+    --normalize \
+    --filtering-mode strict \
+    --skip-duplicates
+
+# Export knowledge graph
+chaoscypher graph package export --output my-knowledge.ccx
+
+# Import knowledge graph
+chaoscypher graph package load my-knowledge.ccx
+
+# Search the graph
+chaoscypher source search "artificial intelligence"
+```
+
+### Upload-time flags (API parity)
+
+`source add` exposes the same upload-time choices the API does. Each flag persists on the source row and is preserved across recovery / retry / re-extract.
+
+| Flag | Default | API equivalent |
+|---|---|---|
+| `--vision/--no-vision` | `--vision` | `enable_vision` |
+| `--content-filtering/--no-content-filtering` | `--content-filtering` | `content_filtering` |
+| `--normalize/--no-normalize` | (file-type default — on for prose, off for CSV/JSON/XML) | `enable_normalization` |
+| `--filtering-mode {maximum,strict,balanced,lenient,minimal,unfiltered}` | unset (resolves to `balanced`) | `filtering_mode` |
+| `--skip-duplicates` | off | `skip_duplicates` |
+
+Run `chaoscypher source add --help` for the full flag list.
+
+## Features
+
+- **Graph Management**: Create, delete, and manage knowledge graphs
+- **Data Import**: Import documents (PDF, DOCX, TXT, CSV, JSON, audio, archives)
+- **Data Export**: Export graphs as `.ccx` packages (CCX — Chaos Cypher eXchange)
+- **Search**: Full-text and vector search across the knowledge graph
+- **Chat**: Interactive AI chat with graph-grounded RAG
+- **Quality**: Run extraction quality scoring and reports
+- **Benchmark**: Run reproducible extraction benchmarks across models
+
+## Development
+
+```bash
+# Run tests
+uv run pytest
+
+# Format code (ruff replaces black; ruff format is the formatter)
+uv run ruff format chaoscypher_cli/
+uv run ruff check chaoscypher_cli/
+
+# Type checking
+mypy chaoscypher_cli/
+```
+
+## Architecture
+
+The CLI is a thin wrapper around the `chaoscypher` core library, providing:
+- User-friendly command-line interface using Click
+- Rich terminal output with progress bars and formatting
+- Configuration management via the unified `settings.yaml` and `CHAOSCYPHER_*` environment variables (managed with `chaoscypher config show/get/set/edit`)
+- Batch operations and scripting support
+
+## Requirements
+
+- Python 3.14+
+- chaoscypher-core>=0.1.0
+
+## License
+
+AGPL-3.0 License - see LICENSE file for details.
+
+## Links
+
+- [ChaosCypher Core Library](https://github.com/chaoscypherinc/chaoscypher)
+- [ChaosCypher Docker App](https://github.com/chaoscypherinc/chaoscypher)
+- [ChaosCypher monorepo](https://github.com/chaoscypherinc/chaoscypher)

chaoscypher_cli-0.1.0/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = ["setuptools>=82.0.0,<90", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "chaoscypher-cli"
+version = "0.1.0"
+description = "Command-line tools for Chaos Cypher knowledge graph library"
+readme = "README.md"
+license = "AGPL-3.0-only"
+authors = [
+    {name = "Denis MacPherson", email = "denis@chaoscypher.com"}
+]
+maintainers = [
+    {name = "Denis MacPherson", email = "denis@chaoscypher.com"}
+]
+keywords = [
+    "knowledge-graph",
+    "cli",
+    "command-line",
+    "chaoscypher"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Environment :: Console",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.14"
+dependencies = [
+    "chaoscypher-core>=0.1.0",
+    "click>=8.3.0,<9",
+    "rich>=15.0.0,<16",
+    "platformdirs>=4.9.0,<5",
+    "pyyaml>=6.0.3,<7",
+    "structlog>=25.5.0,<26",
+    "mcp>=1.27.0,<2",
+    "httpx>=0.28.0,<1",
+]
+
+[project.optional-dependencies]
+server = [
+    "uvicorn>=0.44.0,<1",
+    "fastapi>=0.135.0,<1",
+]
+dev = [
+    "pytest>=9.0.0,<10",
+    "pytest-asyncio>=1.2.0,<2",
+    "pytest-cov>=7.1.0,<8",
+    "ruff>=0.15.0,<1",
+    "mypy>=1.20.0,<2",
+]
+
+[project.scripts]
+chaoscypher = "chaoscypher_cli.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/chaoscypherinc/chaoscypher"
+Documentation = "https://github.com/chaoscypherinc/chaoscypher#readme"
+Repository = "https://github.com/chaoscypherinc/chaoscypher"
+Issues = "https://github.com/chaoscypherinc/chaoscypher/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# Bundle benchmark datasets, corpora, and named configs as package data so
+# they ship in the wheel - that's how `pip install chaoscypher-cli` users
+# get the canonical leaderboard datasets without cloning the repo.
+[tool.setuptools.package-data]
+"chaoscypher_cli.benchmark" = [
+    "data/datasets/*/manifest.yaml",
+    "data/datasets/*/queries.yaml",
+    "data/datasets/*/*.txt",
+    "data/config/*.yaml",
+]
+
+# Linting configuration - inherits from root ruff.toml
+
+[tool.mypy]
+python_version = "3.14"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = ["yaml", "yaml.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+pythonpath = ["src"]

chaoscypher_cli-0.1.0/setup.cfg

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

chaoscypher_cli-0.1.0/src/chaoscypher_cli/__init__.py

@@ -0,0 +1,32 @@
+# Copyright (C) 2024-2026 Chaos Cypher, Inc.
+# SPDX-License-Identifier: AGPL-3.0-only
+
+"""Chaos Cypher CLI - Command-line tools for Chaos Cypher knowledge graph library.
+
+This package provides a user-friendly command-line interface for:
+- Managing knowledge graphs and databases
+- Importing and exporting data
+- Searching and querying graphs
+- Viewing statistics and analytics
+
+Example:
+    chaoscypher db create my-graph
+    chaoscypher source add documents/
+    chaoscypher source search "artificial intelligence"
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+
+try:
+    __version__ = version("chaoscypher-cli")
+except PackageNotFoundError:
+    # Source-tree run without an installed dist (e.g. `python -m chaoscypher_cli`
+    # from a checkout that wasn't `uv sync`'d). Fall back to a sentinel so the
+    # CLI still launches.
+    __version__ = "0.0.0+unknown"
+
+__author__ = "Denis MacPherson"
+__license__ = "AGPL-3.0-only"
+
+__all__ = ["__version__"]