deep-report 0.1.0__tar.gz

deep_report-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Claude Code
+.claude/
+
+# Global state symlink
+.global-state
+
+# OS
+.DS_Store
+Thumbs.db

deep_report-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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.

deep_report-0.1.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: deep-report
+Version: 0.1.0
+Summary: Multi-agent research report generator powered by Claude
+Project-URL: Homepage, https://github.com/lampadare/deep-report
+Project-URL: Repository, https://github.com/lampadare/deep-report
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Deep Report
+
+Multi-agent research reports, powered by Claude.
+
+## Install
+
+```bash
+pipx install deep-report
+```
+
+Requires Python 3.10+ and [Claude Code](https://claude.ai/download) installed and authenticated.
+
+## Use
+
+```bash
+deep-report "quantum computing" --quick
+```
+
+Or configure interactively:
+
+```bash
+deep-report "AI safety" --configure
+```
+
+See all options:
+
+```bash
+deep-report --help
+```
+
+## Claude Code skill
+
+```bash
+deep-report --install-skill
+```
+
+Then in Claude Code: `/deep-report "topic" --quick`
+
+## License
+
+MIT

deep_report-0.1.0/README.md

@@ -0,0 +1,41 @@
+# Deep Report
+
+Multi-agent research reports, powered by Claude.
+
+## Install
+
+```bash
+pipx install deep-report
+```
+
+Requires Python 3.10+ and [Claude Code](https://claude.ai/download) installed and authenticated.
+
+## Use
+
+```bash
+deep-report "quantum computing" --quick
+```
+
+Or configure interactively:
+
+```bash
+deep-report "AI safety" --configure
+```
+
+See all options:
+
+```bash
+deep-report --help
+```
+
+## Claude Code skill
+
+```bash
+deep-report --install-skill
+```
+
+Then in Claude Code: `/deep-report "topic" --quick`
+
+## License
+
+MIT

deep_report-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "deep-report"
+version = "0.1.0"
+description = "Multi-agent research report generator powered by Claude"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "rich>=13.0.0",
+    "requests>=2.28.0",
+    "questionary>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff"]
+
+[project.scripts]
+deep-report = "deep_report.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/lampadare/deep-report"
+Repository = "https://github.com/lampadare/deep-report"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/deep_report"]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+  "SEARCH_TOOLS.md",
+  "SEARCH_TOOLS_FIXES.md",
+  "uv.lock",
+  ".gitignore",
+  "tests/",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

deep_report-0.1.0/src/deep_report/__init__.py

@@ -0,0 +1,3 @@
+"""Deep Report - Multi-agent research report generator."""
+
+__version__ = "0.1.0"

deep_report-0.1.0/src/deep_report/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m deep_report"""
+from .cli import main
+
+if __name__ == "__main__":
+    main()

deep_report-0.1.0/src/deep_report/cli.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""CLI entry point for deep-report."""
+
+import sys
+import shutil
+import subprocess
+from pathlib import Path
+
+
+def check_claude_cli():
+    """Verify Claude CLI is available."""
+    if not shutil.which("claude"):
+        from .orchestrator.ui import ui
+        ui.error("Claude CLI not found.")
+        ui.info("deep-report requires Claude Code to be installed.")
+        ui.info("Install from: https://claude.ai/download")
+        ui.info("After installing, run 'claude' once to authenticate.")
+        sys.exit(1)
+
+
+def check_claude_auth():
+    """Probe Claude CLI authentication. Warns on failure, never blocks."""
+    try:
+        result = subprocess.run(
+            ["claude", "--print", "--model", "haiku", "say ok"],
+            capture_output=True, text=True, timeout=10,
+        )
+        if result.returncode != 0:
+            from .orchestrator.ui import ui
+            ui.warning("Claude CLI may not be authenticated. Run 'claude' to log in.")
+    except subprocess.TimeoutExpired:
+        from .orchestrator.ui import ui
+        ui.warning("Claude CLI auth check timed out. Run 'claude' to verify authentication.")
+    except Exception:
+        # Don't block on unexpected errors
+        pass
+
+
+def main():
+    # Handle --install-skill as alias for --setup-skill
+    if "--install-skill" in sys.argv:
+        sys.argv[sys.argv.index("--install-skill")] = "--setup-skill"
+
+    if "--version" in sys.argv:
+        from . import __version__
+        print(f"deep-report {__version__}")
+        return
+
+    if "--help" not in sys.argv and "-h" not in sys.argv:
+        check_claude_cli()
+
+    # Import and run orchestrator
+    from .orchestrator.main import main as orchestrator_main
+    sys.exit(orchestrator_main())
+
+
+def install_skill():
+    """Install/symlink the Claude Code skill."""
+    from .orchestrator.ui import ui
+
+    import deep_report
+    skill_src = Path(deep_report.__path__[0]) / "skill"
+    skill_dst = Path.home() / ".claude" / "skills" / "deep-report"
+
+    # Create skills directory if needed
+    skill_dst.parent.mkdir(parents=True, exist_ok=True)
+
+    if skill_dst.exists() or skill_dst.is_symlink():
+        ui.info(f"Skill already exists at {skill_dst}")
+        response = input("Replace it? [y/N]: ").strip().lower()
+        if response != 'y':
+            ui.info("Cancelled.")
+            return
+        if skill_dst.is_symlink():
+            skill_dst.unlink()
+        else:
+            import shutil
+            shutil.rmtree(skill_dst)
+
+    try:
+        skill_dst.symlink_to(skill_src)
+    except (OSError, PermissionError) as e:
+        ui.error(f"Could not create skill link: {e}")
+        return
+
+    ui.success(f"Skill installed: {skill_dst} -> {skill_src}")
+    ui.info("You can now use /deep-report in Claude Code")
+
+
+if __name__ == "__main__":
+    main()

deep_report-0.1.0/src/deep_report/orchestrator/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""Deep Report Orchestrator - Script-based multi-agent research."""
+
+from .state import State
+from .main import run_new_report, resume_report
+
+__all__ = ["State", "run_new_report", "resume_report"]