airweave-ai/airweave

Make Any App Searchable for AI Agents

  

⭐ Help us reach more developers and grow the Airweave community. Star this repo!

Overview

Airweave is a tool that lets agents search any app. It connects to apps, productivity tools, databases, or document stores and transforms their contents into searchable knowledge bases, accessible through a standardized interface for agents.

The search interface is exposed via REST API or MCP. When using MCP, Airweave essentially builds a semantically searchable MCP server. The platform handles everything from auth and extraction to embedding and serving.

📺 Check out the quick demo below:

🔗 Example notebooks

Table of Contents

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

🚀 Quick Start

Managed Service: Airweave Cloud

Self-hosted:

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

from airweave import AirweaveSDK

client = AirweaveSDK(
    api_key="YOUR_API_KEY",
    base_url="http://localhost:8001"
)
client.collections.create(
    name="name",
)

TypeScript/JavaScript

1
2
3

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

1
2
3
4
5
6
7
8
9

import { AirweaveSDKClient, AirweaveSDKEnvironment } from "@airweave/sdk";

const client = new AirweaveSDKClient({
    apiKey: "YOUR_API_KEY",
    environment: AirweaveSDKEnvironment.Local
});
await client.collections.create({
    name: "name",
});

🔑 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

🔧 Tech Stack

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

👥 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