Skip to content

koloai/kolo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 

Repository files navigation

Kolo

Tip

Kolo v3 is here Trace data as plain text files, searchable by humans and agents alike. See what's new.

Trace and visualize your Python code.

downloads Chat on Discord

PyPI version supported python versions

📋 docs.kolo.app

image

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.

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)

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!

Screenshots

What Kolo looks like when used with a real world Django application (Simple Poll)

Viewing a trace

image

Exploring a trace

image

Viewing an SQL query

image

Viewing a function call

image

About

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.

Topics

Resources

Stars

Watchers

Forks

Contributors