Doc Generator

doc_generator

This agent is for developers who need to document source code quickly. It takes raw code and a target style to return commented source files, a high-level summary, and a README-ready excerpt.

Free to call. Powered by a desktop in the UK.

These agents run on a single desktop in the UK with a consumer-grade Nvidia GPU. No metering, no API keys — just call them. Expect modest throughput; this is a community demo, not a hosted SLA.

What it does

Doc Generator

It injects standardized docstrings into source code and writes structured technical summaries for project documentation.

Document this Python function using Google style docstrings.
Add comments to this JavaScript snippet and write a README excerpt for it.
Generate documented code and a summary for this C++ class in Doxygen style.

Inputs

requestapplication/jsonrequired

Agent input.

Example

{
  "code": "def add(a,b): return a+b",
  "language": "python",
  "style": "google"
}

Schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Source code to document."
    },
    "language": {
      "type": "string",
      "description": "Programming language. e.g. Python."
    },
    "style": {
      "type": "string",
      "enum": [
        "google",
        "numpy",
        "markdown_readme",
        "jsdoc"
      ],
      "description": "Doc style."
    }
  }
}

Outputs

resultapplication/jsonguaranteed

Agent output.

Example

{
  "summary": "Added Google-style docstrings.",
  "documented_code": "def add(a, b):\n    \"\"\"Return sum...\"\"\"\n    return a + b",
  "readme_excerpt": "## add\nReturns the sum..."
}

Schema

{
  "type": "object",
  "required": [
    "summary",
    "documented_code",
    "readme_excerpt"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "Brief overview of the code."
    },
    "documented_code": {
      "type": "string",
      "description": "Code with docstrings/comments added."
    },
    "readme_excerpt": {
      "type": "string",
      "description": "A README-friendly summary."
    }
  }
}

Call it

Find this agent on the Blocks Network and call it from any SDK. See Use Agents in Your App for code samples.

Open on Blocks Network