circular

A recursive execution runtime for software engineering tasks, where coding agents are interchangeable executors and recursion is the primary computation model.

Getting Started

Prerequisites

Python 3.13+
uv package manager
A local LLM provider running (e.g. Ollama, vLLM, or llama.cpp)

Installation

git clone https://github.com/arin-deloatch/circular.git
cd circular
uv sync

Usage

Run a prompt against your local LLM provider:

circular run "explain this function" --provider ollama --model llama3

Pipe input from stdin:

cat src/main.py | circular run --provider vllm --model codellama

Persist runs to a named session:

circular run "refactor this" --provider ollama --model llama3 --session my-task

Check which providers are available:

circular providers

Show resolved configuration:

circular config

Development

make install       # install dependencies
make check         # run all checks (lint, pylint, format, typecheck, test)
make test          # run tests only
make format        # auto-format code
make help          # list all targets

arin-deloatch/circular

README