Skip to main content
Kapso can research a topic on the public web and hand the findings back as structured sources. This is useful when your knowledge graph doesn’t have the information you need, or when you want fresh implementation references. Research runs as one read-only coding-agent CLI session with live web search — by default the Codex CLI on gpt-5.6-sol, from the platform’s inference block — which searches authoritative sources, cross-validates claims across them, and synthesizes the results into typed sources.

What are the research modes?

mode takes one of three values, or a list of them: The default is ["idea", "implementation"]. A list of modes returns a ResearchFindings with .ideas, .implementations and .report filled per mode; a single mode string returns that mode’s result directly — a bare list, with no .ideas attribute to reach for.

How deep should a search go?

How do I run research?

Single-mode calls

A single mode string skips the ResearchFindings wrapper and returns the results directly:

Research → evolve (add context)

Use research results to provide additional context during solution building:

Research → learn_knowledge (ingest into the graph)

Permanently add research findings to your knowledge graph:

How are sources filtered?

The research system prioritizes sources in this order:
  1. Official documentation — Maintainers, standards bodies
  2. Original papers — arXiv, peer-reviewed publications
  3. Major vendors — OpenAI, Google, Meta, Microsoft, NVIDIA
  4. Well-known engineers — Established track record
Sources that are de-prioritized:
  • SEO content farms
  • Generic blog posts without evidence
  • Single-source claims without corroboration

What comes back?

Idea content sections

Each Source.Idea contains structured content with:
  • Description
  • How to Apply
  • When to Use
  • Why Related
  • Trade-offs
  • Examples
  • Prerequisites
  • Related Concepts

Implementation content sections

Each Source.Implementation contains structured content with:
  • Description
  • Why Related
  • When to Use
  • Code Snippet
  • Dependencies
  • Configuration Options
  • Trade-offs
  • Common Pitfalls
  • Performance Notes

Configuration

Research needs no API key of its own: the session runs on the coding-agent CLI named by the platform’s inference block (shipped: Codex, gpt-5.6-sol, with the CLI’s native web search). kapso doctor research verifies the CLI is installed and logged in before a run spends anything. The full research() signature and the Source.Idea / Source.Implementation / ResearchFindings shapes are in the Python API reference.

Learning Pipeline

Learn how to ingest research into your knowledge graph

Evolve System

Use research context to build better solutions
Related pages: Learning Pipeline · Evolve System Kapso is an open-source framework by Leeroo that builds software toward measurable goals through experiment campaigns. Source code: github.com/Leeroo-AI/kapso · Install: pip install leeroo-kapso · Every page as plain text: llms.txt.