Skip to content
intigraphPublic

About

AI-native knowledge graph with strict ontology enforcement

Topics

Resources

Contributing

Stars

9 stars

Watchers

0 watching

Forks

Latest commit

 

History

2,138 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Quipu logo: knotted strings forming a knowledge graph

Quipu

Governed knowledge your agents can read, reuse and share

License: Apache-2.0 CI crates.io: quipu-ai Docs: the Quipu book DOI: 10.5281/zenodo.21878428 arXiv: 2608.16813 Part of the Tambo stack

Read the book →

Quipu is a governed, bitemporal knowledge store for AI agents and the people who run them. Use it from the command line, REST, MCP or a Rust application.

Why you would want it

  • Governed: check incoming knowledge against your vocabulary and shapes.
  • Bitemporal: keep a queryable history of facts and decisions.
  • Reusable agent knowledge: store memory agents can read, reuse and share across tools.
  • Time-aware entities: attach event-triggering time attributes for Chaski to react to.

Use Quipu as the central graph and base for many tools: see the stack. The full case is in Why Quipu.

Animated: one Quipu store connects the CLI, MCP clients, HTTP server, Rust library, offline use and WebAssembly

Install

curl -fsSL https://raw.githubusercontent.com/intigraph/quipu/main/install.sh | sh

Linux and macOS, x86_64 and arm64; requires Python 3.9+ and curl. The installer verifies the published archive checksum and executable version. Then run quipu --version. Install, upgrade or remove Quipu. For the whole stack, use Tambo's guided onboarding.

First success: insert a fact, watch the graph change

Write one fact in plain Turtle, knot it into a local store, and ask for it back:

printf '@prefix : <urn:demo:> .\n:Ada :studies :Engine .\n' > ada.ttl
quipu knot ada.ttl --db demo.db
quipu read 'SELECT ?who ?what WHERE { ?who <urn:demo:studies> ?what }' --db demo.db

Add a second fact and the graph grows. The first version is still there to query:

printf '@prefix : <urn:demo:> .\n:Babbage :designed :Engine .\n' > babbage.ttl
quipu knot babbage.ttl --db demo.db
quipu read 'SELECT ?s ?p ?o WHERE { ?s ?p ?o }' --db demo.db
quipu read 'SELECT ?s ?p ?o WHERE { ?s ?p ?o }' --tx 1 --db demo.db

Animated terminal: two plain facts are inserted and queried, then the earlier version is read back

After the first factAfter the second fact
Graph before: Ada studies Engine Graph after: Ada studies Engine, and Babbage designed Engine

Transcript, tool version and reproducible capture.

On your own code

Keep project facts, decisions and relationships together instead of pasting the same context into each agent.

You want to Start here
Load facts and apply your vocabulary Quick Start
Ask about current or historical knowledge SPARQL and time
Share a governed knowledge bundle Verified sharing
Prepare domain knowledge and shapes Camayoc

Animated: export a share, verify it in quarantine, then explicitly promote admitted knowledge; conflicts are not silently merged

The latest release includes a repository pendant, checksum and provenance. Verify them together, then use quipu import SHARE_DIR --db repository.db; import stages knowledge and leaves ROOT unchanged. Follow the verified import workflow.

Wire it into your agent

For Claude Code, connect the local MCP server to your database:

claude mcp add quipu -- quipu mcp --db /path/to/knowledge.db

The MCP Registry identifier is mcp-name: io.github.intigraph/quipu. Other clients, HTTP MCP and credential configuration: Agent Setup. Use Tambo to configure and verify the tools together.

Before you start

  • The CLI runs locally; quipu-server supplies the network API and explorer.
  • Fresh stores support keyword search without downloading a model. quipu search "your terms" uses keyword search until an embedding provider is configured; explicit --mode semantic still requires a model and vectors. Install the pinned default model with quipu model install in a full build. Check readiness with quipu doctor search.
  • Configuration covers storage and server settings.

What's next

🧺 The stack

Tambo installs these together and proves each one works; every tool also stands alone. Use each tool's README for its own installation and first success.

The Quipu stack is built around a governed, bitemporal knowledge store: shared facts, decisions and work history your agents can query. Quipu can check writes against your rules, records where each fact came from, and answers what was true when.

tool what it gives your agents
tambo 🧰 Agent Platform Toolkit - installs and configures the quipu stack
quipu stores shared facts with provenance and history; can check writes against your rules
camayoc prepares knowledge and vocabulary for Quipu, with checks before it is admitted
quechua shared vocabulary and shapes for interoperable knowledge
chaski reacts to graph changes and delivers governed notifications
bobbin indexes your codebase and injects context from that index and Quipu knowledge
yupana shows code impact and can read policies from Quipu to govern agent actions
desire-path turns agent mistakes into feature requests; works on its own without Quipu
seeds a work item tracker backed by the Quipu knowledge base
shantytown runs crews of AI agents on work items, triggered by hand, on a schedule or by events; can share work and memory through Quipu
rikuy live brief: status, graphs, watches and signed decisions over Quipu
shuttle runs signed agent workflows and keeps their records in Quipu

Contributing

See CONTRIBUTING.md. The repository's checks are:

just check
just docs check

📜 License

Apache-2.0.

About

AI-native knowledge graph with strict ontology enforcement

Topics

Resources

Contributing

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages