Autonomous QA Intelligence Platform

Software that is tested by software.

intelliqx is a network of 28 specialised agents that plan, generate, execute, and govern your test suite — running anywhere Python runs, with no managed services required.

$ uv sync --all-packages
intelliqx · orchestrator run
live
Plan dag-7f3a · 14 nodes
  • 01 P planner emit DAG
  • 02 R risk_assessment score
  • 03 T test_design 12 cases
  • 04 C code_intel analysing
  • 05 E environment queued
  • 06 X execution queued
  • 07 G release_readiness queued
Trace streaming

12:04:18 planner plan.dag v3 emitted

12:04:19 risk_assessment high → auth.ts:74

12:04:21 test_design 12 cases · 3 negative

12:04:23 code_intel 28 modules indexed

12:04:24 code_intel paths: src/auth/**

12:04:25 environment spinning up container…

Pass rate last 24 runs
98.4% ▲ 1.2%

Powered by a transparent stack

Pydantic AI · LLM runtime
DuckDB · analytical engine
Parquet · graph store
zvec · vector index
sqlite-vec · hybrid search
OpenTelemetry · observability
Pydantic v2 · data models
uv · workspace
Pydantic AI · LLM runtime
DuckDB · analytical engine
Parquet · graph store
zvec · vector index
sqlite-vec · hybrid search
OpenTelemetry · observability
Pydantic v2 · data models
uv · workspace
Plan once. Run anywhere.
Inspectable. Replayable. Durable.
No managed services. No lock-in.
Built for serious test teams.

The platform

A platform, not a patchwork of scripts.

intelliqx replaces ad-hoc test tooling with one runtime, one contract, and one set of agents — so every signal flows through the same path.

Plan 01

Plans are first-class artifacts.

The Planner emits a DAG, the Orchestrator walks it. Every plan is inspectable, replayable, and durable across runs.

Reason 02

Intelligence agents close the loop.

Requirements, code, risk, design, and coverage flow through Pydantic AI agents that produce structured plans — not vibes.

Execute 03

Real tests against real systems.

Environments spin up. Tests run. Selectors heal. Failures are analysed. Nothing ships without evidence.

Govern 04

Every signal is auditable.

Observability, reporting, compliance, and release readiness agents turn raw activity into decisions you can defend.

Tests are not artifacts. They are decisions — and every decision should be inspectable, replayable, and worth defending.

intelliqx · design principle

The agent catalog

28 specialised agents. One runtime. One contract.

Each agent is a single Pydantic AI role. Compose them, swap them, run them in any boundary — they all speak the same protocol.

01 · Coordination
Plan, dispatch, observe.

Stateless, single-purpose agents that emit plans, dispatch DAGs across the platform, and surface the right knowledge at the right time.

P
Planner
planner
Emit a DAG of work.
O
Orchestrator
orchestrator
Dispatch and track plans.
K/
Knowledge / RAG
knowledge_rag
Surface the right context.
TM
Tool Manager
tool_manager
Resolve tools per agent.
S
Smoke
smoke
Single-shot runtime check.
02 · Intelligence
Reason over the system under test.

LLM-using agents that turn requirements, code, and history into structured inputs — risks, designs, data, coverage, and prompts.

RI
Requirements Intel
requirements_intel
Parse ambiguous specs.
CI
Code Intel
code_intel
Read the repo like a senior engineer.
RA
Risk Assessment
risk_assessment
Score risk before you test.
TD
Test Design
test_design
Author scenarios from intent.
TD
Test Data
test_data
Synthesize realistic fixtures.
CA
Coverage Analysis
coverage_analysis
Find what is not tested.
C
Critic
critic
Pressure-test plans and outputs.
L
Learning
learning
Promote lessons into memory.
PM
Prompt Management
prompt_management
Version, evaluate, ship prompts.
03 · Execution
Spin up environments. Run tests. Heal.

Side-effecting agents that prepare environments, execute tests, self-heal selectors, measure performance and security, and recover fast.

E
Environment
environment
Bring up isolated targets.
DI
Design Intel
design_intel
Heuristics from real product UX.
E
Execution
execution
Run the full test plan.
S
Self-Healing
self_healing
Repair broken selectors on the fly.
FA
Failure Analysis
failure_analysis
Root-cause flaky and failing runs.
VR
Visual Regression
visual_regression
Pixel-perfect UI diffs.
A
Accessibility
accessibility
WCAG, keyboard, screen readers.
P
Performance
performance
Latency, throughput, budget.
S
Security
security
SAST, DAST, secrets, authz.
CO
Cost Optimization
cost_optimization
Make every token earn its place.
04 · Governance
Observe, report, release.

Cross-cutting agents that observe the rest of the platform and produce reports, audits, compliance signals, and release decisions.

O
Observability
observability
Metrics, traces, logs.
R
Reporting
reporting
Stakeholder-ready rollups.
C
Compliance
governance_compliance
SOC2, ISO, GDPR signal.
RR
Release Readiness
release_readiness
Gate or green the ship.
28
agents
shipped in 1.0
4
categories
coordination · intelligence · execution · governance
1
role spec
agents/ai/roles.py
compositions
swap, chain, fork

Architecture

One runtime. Four layers. Zero lock-in.

The same agent code runs in any boundary. Choose where each piece lives — and change your mind without rewriting logic.

L1
Surface
process · service · container · cloud
CLI HTTP API Docker Cloud Run
L2
Runtime
one contract, every boundary
InvocationRequest InProcessComputeRuntime ContainerCompute Orchestrator
L3
Agents
Pydantic AI role specs
Planner Orchestrator Intelligence Execution Governance
L4
Stores
contract-tested adapters
Object store State store Event bus Vector index Knowledge graph

Plan → Reason → Execute → Govern

A DAG flows top-down. Every node emits events. Every event is queryable. Every decision is logged.

planner → orchestrator → agents → stores

Contract-tested adapters

Object store, state store, event bus, and vector index all satisfy the same interface. Swap backends without rewrites.

memory · filesystem · cloud

Zero-cost local dev

In-memory adapters make the entire pipeline runnable on a laptop with no external credentials.

$ uv sync --all-packages

Capabilities

Every primitive a serious test platform needs.

Graph storage, vector search, hybrid retrieval, polymorphic memory, contract tests, RBAC, audit — built in, not bolted on.

01 Storage

Knowledge graph on Parquet + DuckDB

Every node, edge, and traversal is queryable through SQL — no managed graph database required, runs anywhere object storage runs.

Learn more
02 Retrieval

Vector search via zvec

Embedded vector store persisted to object storage. Tenant-scoped embeddings with no external services in the loop.

Learn more
03 Search

OKF catalog with hybrid retrieval

SQLite + FTS5 + sqlite-vec combine full-text and vector search over structured documentation, scoped per tenant.

Learn more
04 Memory

Polymorphic memory manager

One agent entry-point handles working, episodic, semantic, and code memories — backed by in-process stores.

Learn more
05 Contracts

Contract-tested adapters

Every object-store, state-store, and event-bus implementation is asserted against the same interface — swap backends freely.

Learn more
06 Governance

RBAC + ABAC + audit trail

Tenant-scoped permissions, dead-letter queues, human approval workflows, and tamper-evident audit records out of the box.

Learn more
07 Local

Zero-cost local dev

In-memory adapters for events, storage, state, vectors, and the LLM client make the entire pipeline runnable on a laptop.

Learn more
08 Runtime

Portable across process and container

The same agent code runs in-process, as a service, or in containers — choose boundaries without rewriting logic.

Learn more

For developers

One API. One runtime. Any boundary.

The same call dispatches in-process, as a service, or in a container. Swap boundaries without changing your code.

examples/orchestrate_checkout.py
# 1. Register the entire agent catalog.
from agents import register_all
from intelliqx_compute.runtime import (
    InvocationRequest,
    get_compute_runtime,
)

# Idempotent. Safe to call from anywhere.
register_all()

import asyncio

async def main() -> None:
    runtime = get_compute_runtime()

    # 2. Describe the intent. The Planner emits a DAG.
    request = InvocationRequest(
        agent_name="orchestrator",
        input={
            "goal": "Verify checkout for new EU tenants.",
            "scope": ["auth", "payments", "checkout"],
            "tenant_id": "tenant-eu-01",
        },
        tenant_id="tenant-eu-01",
    )

    # 3. Invoke. The Orchestrator walks the plan.
    result = await runtime.invoke(request)
    print(result.output)

asyncio.run(main())
stdout exit 0

plan.dag v3 emitted (7 nodes)

risk_assessment medium

test_design 12 cases

environment up (2.1s)

execution 11/12 pass

self_healing 3 selectors

release_readiness green

PlanResult(status=passed, coverage=94%)

$ uv sync --all-packages
$ uv run pytest -q
$ make run-agent AGENT=execution/execution

How a plan flows

From intent to release, in four movements.

Every plan walks the same path — observe, understand, execute, decide — and every step produces inspectable signals you can defend.

01
step

You describe intent

Pass a goal, scope, and tenant. The Planner emits a DAG.

02
step

Intelligence agents reason

Risk, requirements, design, coverage — all in one plan.

03
step

Execution runs tests

Real environments. Real checks. Self-healing included.

04
step

Governance ships the verdict

Reports, audits, and a green-or-red release decision.

100%
events queryable
every agent emits structured events
< 8 ms
p50 invoke
in-process dispatch
15
libraries
15 workspace packages · uv lockfile

Get started

Install once. Run anywhere Python runs.

No accounts. No managed services. No cloud lock-in. Get a working pipeline on your laptop in under two minutes.

1 Install uv
$ curl -LsSf https://astral.sh/uv/install.sh | sh
2 Clone intelliqx
$ git clone https://github.com/sachncs/intelliqx.git
3 Install everything
$ cd intelliqx && uv sync --all-packages
4 Run the suite
$ uv run pytest tests/unit tests/contract -q