AI Worker worker.md

llama-cpp-agent

The llama-cpp-agent framework is a tool designed for easy interaction with Large Language Models (LLMs). Allowing users to chat with LLM models, execute structured function calls and get structured...

Agent framework 617 stars Python NOASSERTION Worker-compatible

Source#

Tags#

agentsfunction-callingllamacppllmllm-agentllm-framework

Integration notes#

Framework-level abstraction; derive bounded worker contracts from concrete tasks and APIs in docs/examples.

worker.md example#

Starter worker.md contract mapped from this registry entry. Copy this file and adapt schemas, constraints, and statuses for your task.

---
id: llama-cpp-agent-repo-derived-worker
name: llama-cpp-agent Repo-Derived Worker
version: 1.0.0
source_registry_url: https://worker.md/registry/llama-cpp-agent/
source_repository: https://github.com/Maximilian-Winter/llama-cpp-agent
repository_default_branch: master
repository_language: Python
repository_license: NOASSERTION
repository_updated_at: 2026-02-27
worker_mode: agent-orchestration-worker
derivation_method: github_repository_metadata_plus_raw_readme
derivation_confidence: 0.45
derived_on: 2026-03-01
tags:
  - agents
  - function-calling
  - llamacpp
  - llm
  - llm-agent
  - llm-framework
---

# llama-cpp-agent Repo-Derived Worker

## Repo-derived summary
- Registry summary: The llama-cpp-agent framework is a tool designed for easy interaction with Large Language Models (LLMs). Allowing users to chat with LLM models, execute structured function calls and get structured...
- Repository description: The llama-cpp-agent framework is a tool designed for easy interaction with Large Language Models (LLMs). Allowing users to chat with LLM models, execute structured function calls and get structured output. Works also with models not fine-tuned to JSON output and function calls.
- Stars (snapshot): 617
- Primary language: Python
- Worker mode classification: agent-orchestration-worker

## Extracted from
- https://github.com/Maximilian-Winter/llama-cpp-agent
- https://github.com/Maximilian-Winter/llama-cpp-agent

## Evidence notes (from repository text)
- README extraction returned low signal; this worker profile is based mostly on repository metadata.

## Installation hints found in README
- No explicit package installation command detected in README text.

## worker.md contract (derived starter)
Purpose: Execute one orchestrated agent task as a bounded worker step.

### Input schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "task",
    "context"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "task": {
      "type": "string"
    },
    "context": {
      "type": "object"
    }
  }
}
```

### Output schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "status",
    "result"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "retryable_error",
        "invalid_request",
        "invalid_output"
      ]
    },
    "result": {
      "type": "object"
    }
  }
}
```

### Constraints
- timeout_seconds: 30
- max_attempts: 2
- idempotency_key: run_id
- status_enum: [ok, retryable_error, invalid_request, invalid_output]
- notes: adapt to concrete APIs/classes documented in this repository before production use

## How this should be used
1. Treat this file as a repo-derived starter profile, not a claim of an official repository API contract.
2. Replace schemas with exact interfaces from code/docs you adopt.
3. Keep execution bounded and auditable using worker protocol constraints.

How to use#

  • Save this as a worker spec file (for example: llama-cpp-agent-my-task.worker.md).
  • Replace the input/output schemas and purpose with your real bounded task.
  • Enforce schema validation + timeout + retry policy in your runtime before production use.

Citation#

Reference URL: https://worker.md/registry/llama-cpp-agent/

Source URL: https://github.com/Maximilian-Winter/llama-cpp-agent