deepy-cli 0.1.1__tar.gz

deepy_cli-0.1.1/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.3
+Name: deepy-cli
+Version: 0.1.1
+Summary: Deepy - Vibe coding for DeepSeek models in your terminal
+Keywords: deepseek,coding-agent,terminal,cli,agents
+Author: kirineko
+Author-email: kirineko <kirineko@qq.com>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Terminals
+Requires-Dist: openai-agents>=0.17.0
+Requires-Dist: openai>=2.26,<3
+Requires-Dist: orjson>=3.10,<4
+Requires-Dist: pydantic>=2.12,<3
+Requires-Dist: prompt-toolkit>=3.0,<4
+Requires-Dist: rich>=13.9,<15
+Requires-Dist: tiktoken>=0.9,<1
+Requires-Dist: tomli-w>=1
+Requires-Python: >=3.12
+Project-URL: Homepage, https://kirineko.github.io/deepy/
+Project-URL: Repository, https://github.com/kirineko/deepy
+Project-URL: Issues, https://github.com/kirineko/deepy/issues
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-logo.png" alt="Deepy logo" width="160">
+</p>
+
+<h1 align="center">Deepy</h1>
+
+<p align="center">
+  A cute terminal coding agent for DeepSeek models.
+  <br>
+  Read, edit, run tools, search the web, and keep project context in one terminal session.
+</p>
+
+<p align="center">
+  <a href="https://kirineko.github.io/deepy/">Website</a>
+  ·
+  <a href="README.zh-CN.md">中文文档</a>
+  ·
+  <a href="#quick-start">Quick Start</a>
+</p>
+
+![Deepy welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.jpg)
+
+## What Is Deepy?
+
+Deepy is a Python terminal coding agent built for DeepSeek's OpenAI-compatible
+models. It keeps the workflow inside your terminal: ask questions, inspect a
+project, edit files, run commands, search or fetch web content, and resume the
+same project session later.
+
+Deepy is designed around DeepSeek V4 thinking mode, long context, cache-friendly
+prompting, and a Rich terminal interface that makes tool calls, diffs, usage, and
+context state visible while the agent works.
+
+## Highlights
+
+- DeepSeek-first model setup with `deepseek-v4-pro`, thinking enabled, and
+  `reasoning_effort=max` by default.
+- OpenAI Agents SDK integration through `OpenAIChatCompletionsModel`.
+- Project-aware coding tools for reading files, modifying files, running shell
+  commands, and showing readable diffs.
+- Web research tools for search and direct URL fetching when a task needs fresh
+  information.
+- Session history, `/resume`, `/new`, automatic context tracking, and compacting
+  for long project work.
+- TOML-only private configuration at `~/.deepy/config.toml`.
+- Terminal UI with Markdown rendering, DeepSeek thinking display, per-turn usage,
+  context window status, and version update checks.
+
+## See It Work
+
+### Start In A Project
+
+Deepy shows the current model, thinking settings, working directory, and the core
+commands directly on startup.
+
+![Deepy startup screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.jpg)
+
+### Build And Verify Code
+
+Ask Deepy to implement a change, write tests, run the project test command, and
+summarize the result.
+
+![Deepy coding workflow with diff](https://raw.githubusercontent.com/kirineko/deepy/main/asset/coding-1.jpg)
+
+Deepy can also turn command output into a readable project summary, including
+files created, code snippets, and test coverage.
+
+![Deepy project summary](https://raw.githubusercontent.com/kirineko/deepy/main/asset/coding-2.jpg)
+
+### Research With Sources
+
+Deepy includes WebSearch and WebFetch tools, so a terminal session can gather
+current information and fetch exact pages when a URL is provided.
+
+![Deepy web research workflow](https://raw.githubusercontent.com/kirineko/deepy/main/asset/websearch.jpg)
+
+## Quick Start
+
+Install from PyPI after the first release:
+
+```bash
+uv tool install deepy-cli
+```
+
+The installed command is still `deepy`.
+
+Install the latest code from GitHub:
+
+```bash
+uv tool install git+https://github.com/kirineko/deepy.git
+```
+
+Configure your DeepSeek API key:
+
+```bash
+deepy config setup
+```
+
+Start Deepy in a project:
+
+```bash
+cd your-project
+deepy
+```
+
+## Configuration
+
+Deepy only uses TOML configuration. JSON config files are intentionally rejected.
+
+```toml
+# ~/.deepy/config.toml
+api_key = "sk-..."
+model = "deepseek-v4-pro"
+base_url = "https://api.deepseek.com"
+context_window_tokens = 1048576
+compact_threshold = 0.8
+```
+
+You can also initialize config non-interactively:
+
+```bash
+deepy config init --api-key sk-... --model deepseek-v4-pro
+```
+
+## Common Commands
+
+```bash
+deepy --version
+deepy config setup
+deepy doctor
+deepy doctor --live --json
+deepy status
+deepy skills list
+deepy sessions list
+deepy sessions show <session-id>
+deepy run "summarize this project"
+```
+
+Inside the interactive terminal:
+
+```text
+/skills   List available skills
+/new      Start a fresh conversation
+/resume   Pick a previous session
+/         Open the command menu
+Esc       Interrupt the current model turn
+Ctrl+D    Press twice to quit
+```
+
+## Project Rules And Skills
+
+Deepy automatically loads project instructions from:
+
+- `AGENTS.md`
+- `.deepy/skills/*/SKILL.md`
+
+This lets each repository define local conventions, commands, review rules, and
+domain-specific skills without changing global config.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check
+uv run pyright
+uv build
+```
+
+The Python package is built from `src/deepy`. GitHub Pages files and screenshot
+assets live outside the package directory and are not included in the wheel.
+
+## Release Status
+
+Deepy is preparing its first public `0.1.1` release. The current release path is
+GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
+primary distribution is the Python CLI.

deepy_cli-0.1.1/README.md

@@ -0,0 +1,177 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-logo.png" alt="Deepy logo" width="160">
+</p>
+
+<h1 align="center">Deepy</h1>
+
+<p align="center">
+  A cute terminal coding agent for DeepSeek models.
+  <br>
+  Read, edit, run tools, search the web, and keep project context in one terminal session.
+</p>
+
+<p align="center">
+  <a href="https://kirineko.github.io/deepy/">Website</a>
+  ·
+  <a href="README.zh-CN.md">中文文档</a>
+  ·
+  <a href="#quick-start">Quick Start</a>
+</p>
+
+![Deepy welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.jpg)
+
+## What Is Deepy?
+
+Deepy is a Python terminal coding agent built for DeepSeek's OpenAI-compatible
+models. It keeps the workflow inside your terminal: ask questions, inspect a
+project, edit files, run commands, search or fetch web content, and resume the
+same project session later.
+
+Deepy is designed around DeepSeek V4 thinking mode, long context, cache-friendly
+prompting, and a Rich terminal interface that makes tool calls, diffs, usage, and
+context state visible while the agent works.
+
+## Highlights
+
+- DeepSeek-first model setup with `deepseek-v4-pro`, thinking enabled, and
+  `reasoning_effort=max` by default.
+- OpenAI Agents SDK integration through `OpenAIChatCompletionsModel`.
+- Project-aware coding tools for reading files, modifying files, running shell
+  commands, and showing readable diffs.
+- Web research tools for search and direct URL fetching when a task needs fresh
+  information.
+- Session history, `/resume`, `/new`, automatic context tracking, and compacting
+  for long project work.
+- TOML-only private configuration at `~/.deepy/config.toml`.
+- Terminal UI with Markdown rendering, DeepSeek thinking display, per-turn usage,
+  context window status, and version update checks.
+
+## See It Work
+
+### Start In A Project
+
+Deepy shows the current model, thinking settings, working directory, and the core
+commands directly on startup.
+
+![Deepy startup screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.jpg)
+
+### Build And Verify Code
+
+Ask Deepy to implement a change, write tests, run the project test command, and
+summarize the result.
+
+![Deepy coding workflow with diff](https://raw.githubusercontent.com/kirineko/deepy/main/asset/coding-1.jpg)
+
+Deepy can also turn command output into a readable project summary, including
+files created, code snippets, and test coverage.
+
+![Deepy project summary](https://raw.githubusercontent.com/kirineko/deepy/main/asset/coding-2.jpg)
+
+### Research With Sources
+
+Deepy includes WebSearch and WebFetch tools, so a terminal session can gather
+current information and fetch exact pages when a URL is provided.
+
+![Deepy web research workflow](https://raw.githubusercontent.com/kirineko/deepy/main/asset/websearch.jpg)
+
+## Quick Start
+
+Install from PyPI after the first release:
+
+```bash
+uv tool install deepy-cli
+```
+
+The installed command is still `deepy`.
+
+Install the latest code from GitHub:
+
+```bash
+uv tool install git+https://github.com/kirineko/deepy.git
+```
+
+Configure your DeepSeek API key:
+
+```bash
+deepy config setup
+```
+
+Start Deepy in a project:
+
+```bash
+cd your-project
+deepy
+```
+
+## Configuration
+
+Deepy only uses TOML configuration. JSON config files are intentionally rejected.
+
+```toml
+# ~/.deepy/config.toml
+api_key = "sk-..."
+model = "deepseek-v4-pro"
+base_url = "https://api.deepseek.com"
+context_window_tokens = 1048576
+compact_threshold = 0.8
+```
+
+You can also initialize config non-interactively:
+
+```bash
+deepy config init --api-key sk-... --model deepseek-v4-pro
+```
+
+## Common Commands
+
+```bash
+deepy --version
+deepy config setup
+deepy doctor
+deepy doctor --live --json
+deepy status
+deepy skills list
+deepy sessions list
+deepy sessions show <session-id>
+deepy run "summarize this project"
+```
+
+Inside the interactive terminal:
+
+```text
+/skills   List available skills
+/new      Start a fresh conversation
+/resume   Pick a previous session
+/         Open the command menu
+Esc       Interrupt the current model turn
+Ctrl+D    Press twice to quit
+```
+
+## Project Rules And Skills
+
+Deepy automatically loads project instructions from:
+
+- `AGENTS.md`
+- `.deepy/skills/*/SKILL.md`
+
+This lets each repository define local conventions, commands, review rules, and
+domain-specific skills without changing global config.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check
+uv run pyright
+uv build
+```
+
+The Python package is built from `src/deepy`. GitHub Pages files and screenshot
+assets live outside the package directory and are not included in the wheel.
+
+## Release Status
+
+Deepy is preparing its first public `0.1.1` release. The current release path is
+GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
+primary distribution is the Python CLI.

deepy_cli-0.1.1/pyproject.toml

@@ -0,0 +1,68 @@
+[project]
+name = "deepy-cli"
+version = "0.1.1"
+description = "Deepy - Vibe coding for DeepSeek models in your terminal"
+readme = "README.md"
+authors = [
+    { name = "kirineko", email = "kirineko@qq.com" }
+]
+requires-python = ">=3.12"
+keywords = ["deepseek", "coding-agent", "terminal", "cli", "agents"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "openai-agents>=0.17.0",
+    "openai>=2.26,<3",
+    "orjson>=3.10,<4",
+    "pydantic>=2.12,<3",
+    "prompt-toolkit>=3.0,<4",
+    "rich>=13.9,<15",
+    "tiktoken>=0.9,<1",
+    "tomli-w>=1",
+]
+
+[project.scripts]
+deepy = "deepy.cli:main"
+
+[project.urls]
+Homepage = "https://kirineko.github.io/deepy/"
+Repository = "https://github.com/kirineko/deepy"
+Issues = "https://github.com/kirineko/deepy/issues"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.407",
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.14",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+exclude = ["dist", "reference", "spec"]
+
+[tool.pyright]
+pythonVersion = "3.12"
+typeCheckingMode = "off"
+include = ["src", "tests"]
+exclude = ["dist", "reference", "spec"]
+reportMissingTypeStubs = false
+
+[tool.uv.build-backend]
+module-name = "deepy"
+
+[build-system]
+requires = ["uv_build>=0.11.10,<0.12.0"]
+build-backend = "uv_build"

deepy_cli-0.1.1/src/deepy/__init__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+__version__ = "0.1.1"
+
+
+def main() -> None:
+    from .cli import main as cli_main
+
+    cli_main()

deepy_cli-0.1.1/src/deepy/__main__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    main()