{"id":23941,"library":"kolo","title":"Kolo","description":"Kolo is a Django development tool that captures and displays everything happening in your running Django app, including SQL queries, HTTP requests, template rendering, and cache operations. Current version: 3.1.0. Supports Python >=3.8. Active development with frequent releases.","status":"active","version":"3.1.0","language":"python","source_language":"en","source_url":"https://github.com/koloai/kolo","tags":["django","debugging","profiling","development-tools","sql-queries"],"install":[{"cmd":"pip install kolo","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"KoloMiddleware is the main entry point, not the top-level package.","wrong":"import kolo","symbol":"KoloMiddleware","correct":"from kolo.middleware import KoloMiddleware"},{"note":"","wrong":"","symbol":"kolo","correct":"import kolo"}],"quickstart":{"code":"# 1. Install: pip install kolo\n# 2. Add to MIDDLEWARE in settings.py:\nMIDDLEWARE = [\n    'kolo.middleware.KoloMiddleware',\n    # ... other middleware\n]\n# 3. Run your Django app, visit any page, and open Kolo UI at /kolo/ in your browser.","lang":"python","description":"Add KoloMiddleware to your Django MIDDLEWARE list to start capturing requests, queries, and more."},"warnings":[{"fix":"Remove old kolo function calls and add 'kolo.middleware.KoloMiddleware' to MIDDLEWARE.","message":"The old style of import (import kolo) and direct usage of kolo functions (e.g., kolo.capture()) is deprecated. Use the middleware approach instead.","severity":"deprecated","affected_versions":"<3.0"},{"fix":"Only use Kolo in Django projects. For Flask, consider alternatives like flask-debugtoolbar.","message":"Kolo only works with Django. Using it in non-Django projects (Flask, FastAPI) will not capture anything and may cause errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Place 'kolo.middleware.KoloMiddleware' as the first item in the MIDDLEWARE list.","message":"KoloMiddleware must be placed early in the MIDDLEWARE list (before any middleware that might modify or short-circuit requests) to capture all request information.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install kolo' to install it.","cause":"Kolo is not installed in the current environment.","error":"ModuleNotFoundError: No module named 'kolo'"},{"fix":"Use 'from kolo.middleware import KoloMiddleware'.","cause":"Trying to import KoloMiddleware directly from the top-level kolo package instead of kolo.middleware.","error":"ImportError: cannot import name 'KoloMiddleware' from 'kolo'"},{"fix":"Add 'kolo.middleware.KoloMiddleware' to your MIDDLEWARE list in Django settings.","cause":"KoloMiddleware is not listed in MIDDLEWARE settings, or the wrong import path was used.","error":"django.core.exceptions.ImproperlyConfigured: The Kolo middleware is not enabled."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}