# oritera/Cairn

A AI general-purpose state-space search engine, validated first on autonomous penetration testing.

Repository: https://github.com/oritera/Cairn
Canonical: https://ross.abutalabs.com/products/cairn
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: ai, ai-agent, ai-cybersecurity, ai-hacker, ai-hacking, blackbox-testing, ctf, ctf-tools, llm, penetration-testing, pentesting, red-teaming, security-automation, security-tools
Last push: 2026-07-15T18:13:31+00:00

## Health v2 (maintenance only)
Score: 72/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 83, longevity 9
- inputs: {"age_days": 136, "days_push": 49, "days_rel": 115, "gap_med": 3.0, "n_releases_24m": 3}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2395, forks 328 (observed 2026-08-28T04:06:43.486147+00:00)

## What it is
Cairn is a general-purpose AI state-space search engine built on a blackboard architecture with a fact-intent graph, where LLM agent workers coordinate via a shared board to find paths from a known origin to a defined goal. It has been validated primarily on autonomous penetration testing and CTF-style challenges.

## Use cases
- automate penetration testing with llm agents
- solve ctf challenges automatically
- run autonomous red team exercises
- search unknown state spaces with ai agents
- coordinate multiple ai agents on a shared blackboard
- automate security testing of a target network

## When to choose
- you need autonomous, goal-driven exploration of an unknown system like a pentest target or CTF challenge
- you want multi-agent coordination without predefined roles or workflows
- you want to inject human judgment mid-run while agents keep working

## When to avoid
- you need a conventional scripted pentesting tool with fixed modules and reports
- your problem lacks a clear origin and success condition
- you cannot allow LLM agents to take actions against systems

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, penetration-testing, llm-inference, security, search-engine
- domain: security, penetration-testing, artificial-intelligence, large-language-models
- platform: python, cli, cross-platform
- tags: blackboard-architecture, state-space-search, llm-agents, red-teaming, ctf-tools, stigmergy, autonomous-agents, security-automation, ai-agents, linux

## Member repositories
- oritera/Cairn (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:43.486147+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:34:23.235900+00:00, confidence not recorded.
  - readme: https://github.com/oritera/Cairn (fetched 2026-08-28T04:06:43.486147+00:00, sha 2d43a5f8fa8a)
- Data as of 2026-08-30T08:39:29.467469+00:00.
