Skip to main content

dgc-sdk

Run the DGC coding agent inside your own Python application or CI job. Version 0.9.0, editor protocol v14, pairs with DGC CLI 0.51.0. Python 3.10+, proven on Linux.

python3 -m pip install dgc-sdk==0.9.0

This installs import dgc_sdk. It is not the unrelated PyPI project dgc.

The SDK drives a dgc serve process from a DGC CLI install, which it finds on its own (dgc on PATH, ~/.local/bin/dgc, or the installer's versions directory). Install the CLI:

curl -fsSL https://vibedgc.com/install.sh | bash

To pin a different install, set DGC_PYTHON to its Python, for example export DGC_PYTHON="$(dirname "$(readlink -f "$(command -v dgc)")")/python".

Point DGC_MODEL and DGC_BASE_URL at an OpenAI-compatible endpoint (for example a local Ollama at http://127.0.0.1:11434/v1), then run this from the repository you want summarized:

import os
import tempfile

from dgc_sdk import DGC

with DGC(
    state_dir=tempfile.mkdtemp(prefix="dgc-sdk-"),
    model=os.environ["DGC_MODEL"],          # for example "qwen3:8b"
    base_url=os.environ["DGC_BASE_URL"],    # for example "http://127.0.0.1:11434/v1"
    api_key=os.environ.get("DGC_API_KEY"),  # only when the endpoint needs a key
) as dgc:
    session = dgc.session(cwd=".", permissions={"mode": "plan", "unhandled": "deny"})
    result = session.run("Summarize this repository in two sentences. Do not edit files.")
    print(result.status, result.final_text)
    if result.error:
        print("error:", result.error)

It prints completed and the summary. Each DGC client keeps its conversations, checkpoints and logs in state_dir, an isolated HOME; your own ~/.dgc is not touched, and an SDK-created temporary state_dir is removed on close().

For untrusted input (a pull request, a cloned repo) the workspace cannot grant the session capabilities: its own .dgc/permissions.json allow rules and .dgc/agents are ignored unless you pass trust_workspace=True. Add a RuntimePolicy to sandbox the shell and confine the file tools, and see the security model in docs/SDK.md.

Licensed under Apache-2.0.

Metadata

Release files for dgc-sdk 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dgc-sdk 0.9.0
File Size Uploaded Provenance Actions
dgc_sdk-0.9.0.tar.gz 200.0 kB With provenance Details for dgc_sdk-0.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dgc-sdk 0.9.0
File Interpreter ABI Platform Actions
dgc_sdk-0.9.0-py3-none-any.whl Python 3 none any Details for dgc_sdk-0.9.0-py3-none-any.whl

Total release size: 409.9 kB

Release files / dgc_sdk-0.9.0.tar.gz

Download URL dgc_sdk-0.9.0.tar.gz
Size 200.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d0f45d8129fe3086287ab2b91de34490a2dcb0335d3645a8c699269ff3edf456
BLAKE2b-256 checksum
How to use checksums
657ab19a35dbbaeea5a4029ab71d1dac4f27307a17e7e500a5a973ef038ae06b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / dgc_sdk-0.9.0-py3-none-any.whl

Download URL dgc_sdk-0.9.0-py3-none-any.whl
Size 209.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8de2f4ec5c245f5f9469ebd32ac148ba38b0c3481f8dd58ad39daa71952233e1
BLAKE2b-256 checksum
How to use checksums
b11d0ded7fc34bc819cb533aad7890463fb3cf64c0c5c98b3bca0205942b324c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for dgc-sdk 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dgc_sdk-0.9.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page