Skip to content

Commit cdca236

Browse files
Reuvenclaude
andcommitted
docs(readme): add downloads badge for rvLite, add Agentic-Synth section
rvLite: - Add downloads badge linking to npm package Agentic-Synth - AI Synthetic Data Generation: - Problem/Solution comparison table - Key features: multi-model, caching, routing, DSPy.ts - Data generation types: time-series, events, structured, embeddings - Quick start with npx commands - Basic usage examples (structured, time-series, streaming) - Self-learning with DSPy optimizer example - Performance metrics (98.2% faster with caching) - Ecosystem integration table Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4c44894 commit cdca236

1 file changed

Lines changed: 145 additions & 0 deletions

File tree

README.md

Lines changed: 145 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1141,6 +1141,7 @@ npm install @ruvector/rudag-wasm
11411141

11421142
[![crates.io](https://img.shields.io/crates/v/rvlite.svg)](https://crates.io/crates/rvlite)
11431143
[![npm](https://img.shields.io/npm/v/@ruvector/rvlite.svg)](https://www.npmjs.com/package/@ruvector/rvlite)
1144+
[![downloads](https://img.shields.io/npm/dt/@ruvector/rvlite.svg)](https://www.npmjs.com/package/@ruvector/rvlite)
11441145

11451146
**A complete vector database that runs anywhere JavaScript runs** — browsers, Node.js, Deno, Bun, Cloudflare Workers, Vercel Edge Functions.
11461147

@@ -1445,6 +1446,150 @@ npm install @ruvector/edge-net
14451446
14461447
</details>
14471448

1449+
<details>
1450+
<summary><strong>🎲 Agentic-Synth - AI Synthetic Data Generation</strong></summary>
1451+
1452+
[![npm](https://img.shields.io/npm/v/@ruvector/agentic-synth.svg)](https://www.npmjs.com/package/@ruvector/agentic-synth)
1453+
[![downloads](https://img.shields.io/npm/dt/@ruvector/agentic-synth.svg)](https://www.npmjs.com/package/@ruvector/agentic-synth)
1454+
1455+
**AI-Powered Synthetic Data Generation at Scale** — Generate unlimited, high-quality synthetic data for training AI models, testing systems, and building robust agentic applications.
1456+
1457+
### Why Agentic-Synth?
1458+
1459+
| Problem | Solution |
1460+
|---------|----------|
1461+
| Real data is **expensive** to collect | Generate **unlimited** synthetic data |
1462+
| **Privacy-sensitive** with compliance risks | **Fully synthetic**, no PII concerns |
1463+
| **Slow** to generate at scale | **10-100x faster** than manual creation |
1464+
| **Insufficient** for edge cases | **Customizable** schemas for any scenario |
1465+
| **Hard to reproduce** across environments | **Reproducible** with seed values |
1466+
1467+
### Key Features
1468+
1469+
| Feature | Description |
1470+
|---------|-------------|
1471+
| **Multi-Model Support** | Gemini, OpenRouter, GPT, Claude, and 50+ models via DSPy.ts |
1472+
| **Context Caching** | 95%+ performance improvement with intelligent LRU cache |
1473+
| **Smart Model Routing** | Automatic load balancing, failover, and cost optimization |
1474+
| **DSPy.ts Integration** | Self-learning optimization with 20-25% quality improvement |
1475+
| **Streaming** | AsyncGenerator for real-time data flow |
1476+
| **Memory Efficient** | <50MB for datasets up to 10K records |
1477+
1478+
### Data Generation Types
1479+
1480+
| Type | Use Cases |
1481+
|------|-----------|
1482+
| **Time-Series** | Financial data, IoT sensors, metrics |
1483+
| **Events** | Logs, user actions, system events |
1484+
| **Structured** | JSON, CSV, databases, APIs |
1485+
| **Embeddings** | Vector data for RAG systems |
1486+
1487+
### Quick Start
1488+
1489+
```bash
1490+
# Install
1491+
npm install @ruvector/agentic-synth
1492+
1493+
# Or run instantly with npx
1494+
npx @ruvector/agentic-synth generate --count 100
1495+
1496+
# Interactive mode
1497+
npx @ruvector/agentic-synth interactive
1498+
```
1499+
1500+
### Basic Usage
1501+
1502+
```typescript
1503+
import { AgenticSynth } from '@ruvector/agentic-synth';
1504+
1505+
// Initialize with your preferred model
1506+
const synth = new AgenticSynth({
1507+
model: 'gemini-pro',
1508+
apiKey: process.env.GEMINI_API_KEY
1509+
});
1510+
1511+
// Generate structured data
1512+
const users = await synth.generate({
1513+
schema: {
1514+
name: 'string',
1515+
email: 'email',
1516+
age: 'number:18-65',
1517+
role: ['admin', 'user', 'guest']
1518+
},
1519+
count: 1000
1520+
});
1521+
1522+
// Generate time-series data
1523+
const stockData = await synth.timeSeries({
1524+
fields: ['open', 'high', 'low', 'close', 'volume'],
1525+
interval: '1h',
1526+
count: 500,
1527+
volatility: 0.02
1528+
});
1529+
1530+
// Stream large datasets
1531+
for await (const batch of synth.stream({ count: 100000, batchSize: 1000 })) {
1532+
await processData(batch);
1533+
}
1534+
```
1535+
1536+
### Self-Learning with DSPy
1537+
1538+
```typescript
1539+
import { AgenticSynth, DSPyOptimizer } from '@ruvector/agentic-synth';
1540+
1541+
// Enable self-learning optimization
1542+
const synth = new AgenticSynth({
1543+
model: 'gemini-pro',
1544+
optimizer: new DSPyOptimizer({
1545+
learningRate: 0.1,
1546+
qualityThreshold: 0.85
1547+
})
1548+
});
1549+
1550+
// Quality improves automatically over time
1551+
const data = await synth.generate({
1552+
schema: { ... },
1553+
count: 1000,
1554+
optimize: true // Enable learning
1555+
});
1556+
1557+
console.log(`Quality score: ${data.metrics.quality}`);
1558+
// First run: 0.72
1559+
// After 100 runs: 0.94 (+25% improvement)
1560+
```
1561+
1562+
### Performance
1563+
1564+
| Metric | Value |
1565+
|--------|-------|
1566+
| **With caching** | 98.2% faster |
1567+
| **P99 latency** | 2500ms → 45ms |
1568+
| **Memory** | <50MB for 10K records |
1569+
| **Throughput** | 1000+ records/sec |
1570+
1571+
### Ecosystem Integration
1572+
1573+
| Package | Purpose |
1574+
|---------|---------|
1575+
| **RuVector** | Native vector database for RAG |
1576+
| **DSPy.ts** | Prompt optimization |
1577+
| **Agentic-Jujutsu** | Version-controlled generation |
1578+
1579+
### Installation
1580+
1581+
```bash
1582+
# npm
1583+
npm install @ruvector/agentic-synth
1584+
1585+
# Examples package (50+ production examples)
1586+
npm install @ruvector/agentic-synth-examples
1587+
```
1588+
1589+
> **Full Documentation**: [agentic-synth README](./npm/packages/agentic-synth/README.md)
1590+
1591+
</details>
1592+
14481593
<details>
14491594
<summary><strong>🐘 PostgreSQL Extension</strong></summary>
14501595

0 commit comments

Comments
 (0)