Airweave is a tool that lets agents semantically search any application or database. It's MCP compatible and seamlessly connects any app, database, or API, to transform their contents into agent-ready knowledge.
airweave_launch_bf_demo_vid_inverted_4k.mp4
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
- Overview
- Quick Start
- Usage
- Integrations - adding more every day!
- Key Features
- Technology Stack
- Contributing
- Roadmap
- License
- Contact & Community
Below is a simple guide to get Airweave up and running locally. For more detailed instructions, refer to the docs.
-
Clone the Repository
git clone https://github.com/airweave-ai/airweave.git cd airweave -
Build and Run
chmod +x start.sh ./start.sh
That's it!
You now have Airweave running locally. You can log in to the dashboard, add a connection, configure your sync schedule and find information on your apps.
To use Airweave, you can either use the frontend or the API.
- Access the React UI at
http://localhost:8080. - Navigate to Sources to add new integrations.
- Set up or view your sync schedules under Schedules.
- Monitor sync jobs in Jobs.
- Swagger Documentation:
http://localhost:8001/docs - Get All Sources:
GET /sources - Connect a Source:
POST /connections/{short_name} - Find information::
POST /search
- Over 25 integrations and counting: Airweave is your one-stop shop for building agents that need to find information in a single queryable layer.
- Simplicity: Minimal configuration needed to find information in diverse sources: APIs, databases, apps and more.
- Extensibility: Easily add new source and embedder integrations with our
- White-Labeled Multi-Tenant Support: Ideal for SaaS builders, Airweave provides a streamlined OAuth2-based platform for syncing data across multiple tenants while maintaining privacy and security.
- Entity Generators: Each source (like a database, API, or file system) defines a
async def generate_entities()that yields data in a consistent format. You can also define your own. - Automated Sync: Schedule data synchronization or run on-demand sync jobs.
- Versioning & Hashing: Airweave detects changes in your data via hashing, updating only the modified entities.
- Async-First: Built to handle large-scale data synchronization asynchronously (upcoming: managed Redis workers for production scale).
- Scalable: Deploy locally via Docker Compose for development (upcoming: deploy with Kubernetes for production scale)
- Frontend: React (JavaScript/TypeScript)
- Backend: FastAPI (Python)
- Infrastructure:
- Local / Dev: Docker Compose
- Production: (upcoming) Kubernetes
- Databases:
- PostgreSQL for relational data
- Vector database: Qdrant
- Asynchronous Tasks: ARQ Redis for background workers
We welcome all contributions! Whether you're fixing a bug, improving documentation, or adding a new feature:
Please follow the existing code style and conventions. See CONTRIBUTING.md for more details.
- Additional Integrations: Expand entity generators for popular SaaS APIs and databases.
- Redis & Worker Queues: Improved background job processing and caching for large or frequent syncs.
- Webhooks: Trigger syncs on external events (e.g., new data in a database).
- Kubernetes Support: Offer easy Helm charts for production-scale deployments.
- Commercial Offerings: Enterprise features, extended metrics, and priority support.
Airweave is released under an open-core model. The community edition is licensed under the MIT. Additional modules (for enterprise or advanced features) may be licensed separately.
- Discord: Join our Discord channel here to get help or discuss features.
- GitHub Issues: Report bugs or request new features in GitHub Issues.
- Twitter: Follow @airweave_ai for updates.
That's it! We're looking forward to seeing what you build. If you have any questions, please don't hesitate to open an issue or reach out on Discord.