Коллекция Weaviate Skills

Полный набор Claude Skills для работы с локальными векторными базами данных Weaviate. Эти скиллы позволяют подключаться к Weaviate, запущенному в Docker, управлять им, загружать данные и выполнять запросы — прямо из Claude.ai или Claude Desktop.

Важно: требуется локальный Weaviate

Скиллы рассчитаны на ЛОКАЛЬНЫЕ экземпляры Weaviate, запущенные в Docker.

⚠️ Claude Desktop и Claude Web имеют сетевые ограничения, которые блокируют подключение к внешним сервисам, таким как Weaviate Cloud. Поэтому скиллы используют локальный Docker-экземпляр Weaviate на localhost:8080 без сетевых ограничений.

Преимущества локальной установки:

• ✅ Нет сетевых ограничений в Claude
• ✅ Бесплатно (без облачных расходов)
• ✅ Быстрые локальные запросы
• ✅ Полная конфиденциальность и контроль над данными
• ✅ Работает офлайн (с векторизатором transformers)

Что такое Claude Skills?

Claude Skills — это самодостаточные модули знаний, которые Claude загружает по запросу. Каждый скилл — это папка с файлом SKILL.md, содержащим инструкции, примеры кода и лучшие практики для конкретной задачи.

Скиллы обеспечивают:

• Прогрессивное раскрытие: Claude загружает только то, что нужно
• Компонуемость: скиллы могут зависеть от других скиллов
• Переносимость: легко делиться и переиспользовать в разных проектах
• Без деплоя: работает напрямую в Claude.ai Web или Claude Desktop
• Удобство для клиентов: просто скачайте папки и начните работу
• Локальный приоритет: Weaviate в Docker, без внешних зависимостей

Доступные скиллы

0. weaviate-local-setup ← НАЧНИТЕ ЗДЕСЬ

Настройка и управление локальным экземпляром Weaviate в Docker для разработки и тестирования.

Когда использовать: перед всем остальным — настраивает локальную базу данных Weaviate

Ключевые возможности:

• Конфигурации Docker и Docker Compose
• Несколько вариантов векторизатора (transformers, OpenAI, Cohere)
• Персистентность данных и резервное копирование
• Без облачных расходов и сетевых ограничений
• Идеально для сред Claude Desktop/Web

1. weaviate-connection

Подключение к локальному экземпляру Weaviate и проверка состояния соединения.

Когда использовать: после запуска Weaviate — устанавливает соединение с базой данных

Ключевые возможности:

• Локальное подключение к Docker-экземпляру
• Управление переменными окружения
• Проверка работоспособности соединения
• Диагностика ошибок

2. weaviate-collection-manager

Создание, просмотр, обновление и удаление коллекций Weaviate с полным управлением схемой.

Когда использовать: настройка схемы базы данных, управление коллекциями

Ключевые возможности:

• Просмотр и инспекция коллекций
• Создание коллекций с различными векторизаторами
• Настройка RAG и реранкинга
• Справочные таблицы типов данных
• Поддержка мультимодальных коллекций

3. weaviate-data-ingestion

Загрузка данных в коллекции Weaviate: одиночные объекты, пакетная загрузка и мультимодальный контент.

Когда использовать: добавление документов, изображений или любых данных в коллекции

Ключевые возможности:

• Одиночная и пакетная вставка объектов
• Импорт файлов JSON/CSV
• Загрузка изображений (кодирование base64)
• Стратегии разбивки документов на чанки
• Отслеживание прогресса при больших загрузках
• Обработка ошибок и валидация

4. weaviate-query-agent

Поиск и извлечение данных с помощью семантического поиска, фильтров, RAG и гибридных запросов.

Когда использовать: поиск по коллекциям, вопросно-ответные системы, поиск похожих объектов

Ключевые возможности:

• Семантический векторный поиск
• Ключевой поиск (BM25)
• Гибридный поиск
• Расширенная фильтрация
• RAG (Retrieval Augmented Generation)
• Мультимодальный поиск по изображениям
• Агрегация и аналитика

Быстрый старт

Шаг 1: Получите скиллы

Вариант A: Скачать

1. Скачайте репозиторий как ZIP
2. Распакуйте папку weaviate-skills
3. Поместите её в удобное место (например, ~/Documents/)

Вариант B: Клонировать

git clone https://github.com/saskinosie/weaviate-claude-skills.git ~/Documents/weaviate-claude-skills

Вариант C: Интеграция в проект

1. Добавьте weaviate-skills/ в репозиторий вашего проекта
2. Зафиксируйте скиллы вместе с кодом

Шаг 2: Настройте окружение Python (опционально)

Claude сделает это автоматически, но при желании можно настроить вручную:

cd weaviate-claude-skills

# Создать виртуальное окружение
python3 -m venv .venv

# Активировать его
source .venv/bin/activate  # macOS/Linux
# ИЛИ
.venv\Scripts\activate     # Windows

# Установить зависимости
pip install -r requirements.txt

Примечание: при использовании скиллов с Claude он сам проверит зависимости и при необходимости создаст виртуальное окружение.

Шаг 3: Запустите локальный Weaviate

Обязательно: Docker Desktop должен быть установлен и запущен

cd weaviate-claude-skills/weaviate-local-setup
docker-compose up -d

Подождите 10–15 секунд для запуска, затем проверьте:

Шаг 4: Используйте в Claude

Claude.ai Web:

1. Откройте Claude.ai
2. Прикрепите нужные файлы SKILL.md (лимит вложений: 20 файлов)
3. Прикрепите файл .env
4. Напишите: «Подключись к моему локальному экземпляру Weaviate»

Claude Desktop:

1. Откройте Claude Desktop
2. Укажите папку со скиллами в разговоре
3. Напишите: «У меня есть Weaviate skills в ~/Documents/weaviate-skills. Подключись к моему локальному экземпляру Weaviate.»

Примечание: из-за лимита в 20 вложений в Claude Web может потребоваться загружать скиллы по одному, а не всю папку целиком (папка .git содержит много файлов). В Claude Desktop такого ограничения нет.

Детали установки

Окружение Python

Claude управляет зависимостями автоматически! При первом использовании скиллов Claude:

1. Проверит наличие виртуального окружения
2. Создаст .venv/, если нужно
3. Установит необходимые пакеты (weaviate-client, python-dotenv и др.)
4. Запустит весь Python-код внутри виртуального окружения

Ручная настройка (опционально):

cd weaviate-claude-skills
python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
pip install -r requirements.txt