Airweave — прослойка для контекстного поиска AI-агентов

Airweave — это open-source слой извлечения контекста для AI-агентов и RAG-систем. Он подключается к вашим приложениям, базам данных и документам, непрерывно синхронизирует данные и предоставляет к ним единый поисковый интерфейс, удобный для LLM. Агенты запрашивают Airweave и получают релевантный, актуальный контекст из нескольких источников за один запрос.

Как это работает

1. Подключение — вы добавляете источники данных (приложения, БД, документы, 50+ интеграций).
2. Синхронизация и индексация — Airweave автоматически синхронизирует, индексирует и выставляет данные через единый слой извлечения.
3. Запрос — агенты обращаются к Airweave через SDK, REST API, MCP или встроенные интеграции с популярными фреймворками агентов.
4. Ответ — агенты получают только нужный, релевантный контекст.

Варианты использования

• Облачный хостинг — app.airweave.ai (готовый сервис).
• Self-hosted — полный контроль над данными, запуск локально.

Быстрый старт (self-hosted)

Требования

• Docker и docker-compose.

Установка и запуск

git clone https://github.com/airweave-ai/airweave.git
cd airweave
./start.sh

Скрипт автоматически:

• создаст файл .env из .env.example;
• сгенерирует секреты (ENCRYPTION_KEY, STATE_SECRET);
• запустит все сервисы с проверкой здоровья;
• опционально запросит API-ключи OpenAI/Mistral.

После запуска приложение будет доступно по адресу http://localhost:8080. Первый запуск может занять 2–3 минуты.

Полезные команды

• ./start.sh --restart — перезапустить сервисы.
• ./start.sh --skip-frontend — запустить только бэкенд.
• ./start.sh --destroy — полностью очистить окружение.

Возможные проблемы

• Порты уже заняты (8080, 8001, 5432, 6333, 6379, 7233, 8081, 8088).
• Docker не запущен.
• Проверьте логи: docker logs airweave-backend или docker logs airweave-frontend.

SDK и примеры

Python

pip install airweave-sdk

from airweave import AirweaveSDK

client = AirweaveSDK(api_key="YOUR_API_KEY")
results = client.collections.search(
    readable_id="my-collection",
    query="Найди последние неудачные платежи"
)

TypeScript

npm install @airweave/sdk

Больше примеров — в репозитории.

Интеграции

Полный список поддерживаемых коннекторов: документация.

Технологический стек

• Фронтенд: React/TypeScript с ShadCN.
• Бэкенд: FastAPI (Python).
• Базы данных: PostgreSQL (метаданные), Vespa (векторы).
• Оркестрация: Temporal, Redis (pub/sub).
• Деплой: Docker Compose (dev), Kubernetes (prod).

Вклад в проект

Мы приветствуем contributions! Ознакомьтесь с гайдом.

Лицензия

MIT. Подробнее — LICENSE.

Ссылки

• Веб-приложение
• Документация
• Discord
• Twitter/X
• GitHub Issues