airweave-ai/airweave

Airweave

Airweave is a tool that lets agents semantically search any app. It’s MCP compatible and seamlessly connects any app, database, or API, to transform their contents into agent-ready knowledge.

Overview

Airweave simplifies the process of making information retrievable for your agent. Whether you have structured or unstructured data, Airweave helps you break it into processable entities, store the data and make it retrievable through REST and MCP endpoints.

Table of Contents

• Airweave
  • 🎥 Watch Demo
  • Overview
  • Table of Contents
  • 🚀 Quick Start
  • 🔌 Supported Integrations
  • 💻 Usage
    • Frontend
    • API
  • 📦 SDKs
    • Python
    • TypeScript/JavaScript
  • 🔑 Key Features
  • 🔧 Technology Stack
  • 🛣️ Roadmap
  • 👥 Contributing
  • 📄 License
  • 🔗 Connect

🚀 Quick Start

Make sure docker and docker-compose are installed, then…

1
2
3
4
5
6
7

# 1. Clone the repository
git clone https://github.com/airweave-ai/airweave.git
cd airweave

# 2. Build and run
chmod +x start.sh
./start.sh

That’s it! Access the dashboard at http://localhost:8080

🔌 Supported Integrations

💻 Usage

Frontend

• Access the UI at http://localhost:8080
• Connect sources, configure syncs, and query data

API

• Swagger docs: http://localhost:8001/docs
• Create connections, trigger syncs, and search data

📦 SDKs

Python

1

pip install airweave-sdk

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

from airweave import AirweaveClient

client = AirweaveClient(api_key="your-api-key")

# List all sources
sources = client.sources.list()

# Create a sync job
job = client.sync.create_sync(
  name="My first sync",
  source_connection_id=source_id,
  run_immediately=True
)

TypeScript/JavaScript

1
2
3

npm install @airweave/sdk
# or
yarn add @airweave/sdk

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

import { AirweaveClient } from "@airweave/sdk";

const client = new AirweaveClient({
  apiKey: "your-api-key",
});

// List sources
const sources = await client.sources.list();

// Create a sync job
const job = await client.sync.create_sync({
  name: "My first sync",
  source_connection_id: sourceId,
  run_immediately: true,
});

🔑 Key Features

• Data synchronization from 25+ sources with minimal config
• Entity extraction and transformation pipeline
• Multi-tenant architecture with OAuth2
• Incremental updates using content hashing
• Semantic search for agent queries
• Versioning for data changes
• White-labeling support for SaaS builders

🔧 Technology Stack

• Frontend: React/TypeScript with ShadCN
• Backend: FastAPI (Python)
• Databases: PostgreSQL (metadata), Qdrant (vectors)
• Deployment: Docker Compose (dev), Kubernetes (prod)

🛣️ Roadmap

• Additional source integrations
• Redis worker queues for large-scale syncs
• Webhooks for event-driven syncs
• Kubernetes support via Helm charts

👥 Contributing

We welcome contributions! Please check CONTRIBUTING.md for details.

📄 License

Airweave is released under the MIT license.

🔗 Connect

• Discord - Get help and discuss features
• GitHub Issues - Report bugs or request features
• Twitter - Follow for updates