| .. | ||
| browser | ||
| cache-performance-demo.ts | ||
| docker-compose.observability.yml | ||
| federated-learning-example.ts | ||
| grafana-dashboard.json | ||
| otel-collector-config.yaml | ||
| parallel-batch-insert.ts | ||
| prometheus.yml | ||
| quickstart.js | ||
| README.md | ||
| telemetry-integration-batch.ts | ||
| telemetry-integration-cache.ts | ||
| telemetry-integration-reflexion.ts | ||
| telemetry-integration-skills.ts | ||
AgentDB Examples
Practical examples demonstrating how to use AgentDB programmatically.
Prerequisites
npm install agentdb@alpha
Examples
1. quickstart.js - Basic Usage
Simple example showing database initialization and version checking.
node examples/quickstart.js
What it demonstrates:
- Creating a database instance
- Accessing package version
- Basic error handling
2. reflexion-memory.js (Coming in alpha.3)
Store and retrieve episodic memories using the Reflexion pattern.
Features:
- Episode storage
- Similarity-based retrieval
- Pattern recognition
3. skill-library.js (Coming in alpha.3)
Manage reusable skills with version control.
Features:
- Skill storage
- Version management
- Skill retrieval
4. causal-reasoning.js (Coming in alpha.3)
Build causal graphs for explainable AI decisions.
Features:
- Causal edge creation
- Counterfactual reasoning
- Causal path queries
Current Limitations (Alpha.2)
Note: The programmatic API is under active development. For alpha.2:
-
Use CLI for initialization:
npx agentdb@alpha init --db ./my-database.db -
Schemas not auto-created: You must run
agentdb initbefore using the database programmatically -
Limited examples: More comprehensive examples coming in alpha.3
Recommended Workflow (Alpha.2)
Step 1: Initialize via CLI
npx agentdb@alpha init --db ./agent-memory.db --dimensions 384
Step 2: Use programmatically
import { createDatabase } from 'agentdb';
const db = await createDatabase('./agent-memory.db');
// Database is ready to use
Coming in Alpha.3
- ✅ Auto-initialization:
AgentDB.create(config)factory method - ✅ Complete examples for all features
- ✅ TypeScript examples
- ✅ Integration examples
Get Help
- Documentation: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
- Issues: https://github.com/ruvnet/agentic-flow/issues
- CLI Help:
npx agentdb@alpha --help
Contributing Examples
Have a cool example? Submit a PR!
- Create your example in
/examples/your-example.js - Add documentation to this README
- Ensure it works with current alpha version
- Submit PR with description
Note: These examples are for AgentDB v2.0 alpha. The API may change before stable release.