https://github.com/koloai/kolo

Kolo is a text-based Python debugger for AI agents. Capture every executed function call, return value, local variable, HTTP request, and more in greppable trace files.
https://github.com/koloai/kolo

ai ai-agents django python web

Last synced: 5 days ago
JSON representation

Kolo is a text-based Python debugger for AI agents. Capture every executed function call, return value, local variable, HTTP request, and more in greppable trace files.

• Host: GitHub
• URL: https://github.com/koloai/kolo
• Owner: koloai
• Created: 2021-06-01T08:25:19.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2026-04-17T00:50:14.000Z (8 days ago)
• Last Synced: 2026-04-17T02:36:13.188Z (8 days ago)
• Topics: ai, ai-agents, django, python, web
• Homepage: https://kolo.app
• Size: 128 KB
• Stars: 525
• Watchers: 4
• Forks: 14
• Open Issues: 18
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Kolo

> [!TIP]

> **Kolo v3 is here**

> Trace data as plain text files, searchable by humans and agents alike. [See what's new](https://docs.kolo.app/changelog/#v3-0-0).

Trace and visualize your Python code.

[![downloads](https://img.shields.io/pypi/dm/kolo)](https://pypi.org/project/kolo/) [![Chat on Discord](https://img.shields.io/discord/899363528660635738?label=Chat%20on%20Discord)](https://discord.com/invite/FsTVcFwYUn)

[![PyPI version](https://img.shields.io/pypi/v/kolo?label=python%20package)](https://pypi.org/project/kolo/) [![supported python versions](https://img.shields.io/pypi/pyversions/kolo)](https://pypi.org/project/kolo/)

📋 [docs.kolo.app](https://docs.kolo.app)



Screenshot of Kolo from the Todo Demo app


## Quickstart

Getting started with Kolo only takes a couple of minutes. The fastest way to understand what Kolo does and how it can be helpful is by trying it out on a codebase you work on. But if you're in a hurry or can't try Kolo on your own codebase, you can preview some functionality in our [playground](https://play.kolo.app).

### Trace a Django request

_Trace a Django request for inspection, visualization, and debugging purposes._

1. Install kolo using `pip install kolo`

2. Add `"kolo.middleware.KoloMiddleware"` to the top of your MIDDLEWARE list in settings.py

3. Start your Django server using `python manage.py runserver` and make a request to any page.

4. Browse to `localhost:8000/_kolo/` to view your traced request. It should look similar to the screenshot at the top of the page 🚀

(For a more in-depth version of this tutorial see [How to: Trace Django requests](https://docs.kolo.app/en/latest/howto/trace-django-requests.html))

## Support

If you have any questions or trouble getting set up with Kolo, please get in touch with us. We're here to help and would love any feedback!

- [Talk to us on Discord](https://discord.com/invite/FsTVcFwYUn)

- [Create an issue](https://github.com/koloai/kolo/issues/new/choose)

- [Email us](mailto:support@kolo.app)

- [Schedule a meeting with us to help get Kolo set up](https://calendly.com/wilhelmklopp)

## Screenshots

What Kolo looks like when used with a real world Django application ([Simple Poll](https://simplepoll.rocks))

#### Viewing a trace



#### Exploring a trace



#### Viewing an SQL query



#### Viewing a function call