vespper

Vespper-Разработчик по вызову с открытым исходным искусством.

Документы · Демонстрация · Отчет об ошибке · Запрос на функции · Блог · Slack

Примечание. Если вы хотите использовать Vespper для вашей команды или для вашей организации, пожалуйста, обратитесь к нам. Этот проект с открытым исходным кодом подходит для отдельного индивидуального использования. Любые усовершенствованные функции расследования будут находиться под Vespper-EE.

Вы можете оставить свою электронную почту, чтобы быть уведомленным, когда доступно наше облачное предложение: https://tally.so/r/3eba5l

Обзор?

Vespper-инженер по вызову с AI. Он может автоматически запрыгнуть в инциденты и оповещения с вами и предоставить вам полезную и контекстную информацию и RCA в режиме реального времени.

Почему ❓

Большинство людей не любят делать смены по вызову. Это требует, чтобы инженеры были быстрыми и быстро решали проблемы. Более того, требуется время, чтобы достичь первопричины проблемы. Вот почему мы разработали Весппер. Мы считаем, что Gen AI может помочь разработчикам по вызову решать проблемы быстрее.

Оглавление

• Обзор
• Почему
• Ключевые функции
• Демо
• Начиная
  • Предварительные условия
  • Быстрая установка
  • Обновление Vespper
  • Развертывание
  • Визуализировать базу знаний
• Поддержка и обратная связь
• Вклад в Весппер
• Поиск неисправностей
• Телеметрия
• Лицензия
• Узнать больше
• Участники

Ключевые функции

• Automatic RCA : Vespper автоматически слушает инциденты/оповещения производства и автоматически исследует их для вас.
• Slack Integration : Весппер живет в вашем слабых. Просто подключите его и наслаждайтесь инженером по вызову, который никогда не спит.
• Интеграции : Весппер интегрируется с популярными инструментами наблюдения/инцидентов, такими как DataDog, Coralogix, Opsgenie и Pagerduty. Он также интегрируется на другие инструменты, такие как GitHub, Intision, Jira и Confluence, чтобы получить представление о инцидентах.
• Интуитивно понятный UX : Весппер предлагает знакомый опыт. Вы можете поговорить с этим и задать последующие вопросы.
• Secure : Self-Host Vespper и владеет вашими данными. Всегда.
• Открытый исходный код : мы любим открытый исход. Самоухост Весппер и используйте его бесплатно.

Демонстрация?

Проверьте наше демонстрационное видео, чтобы увидеть Весппер в действии.

Начиная

Чтобы запустить Vespper, вам нужно клонировать репо и запустить приложение с помощью Docker Compose.

Предварительные условия

Убедитесь, что у вас установлено следующее:

• Docker & Docker Compose - приложение работает с контейнерами Docker. Чтобы запустить его, вам нужно иметь Docker Desktop, который поставляется с Docker CLI, Docker Engine и Docker Compose.

Быстрая установка? ️

Вы можете найти видео установки здесь.

1. Клонировать репозиторий:

   git clone [email protected]:vespper/vespper.git && cd vespper

2. Настройка прокси -сервера Litellm:

   Мы используем прокси -сервер Litellm для взаимодействия с 100+ LLMS в унифицированном интерфейсе (интерфейс OpenAI).

   1. Скопируйте пример файлов:

      cp config/litellm/.env.example config/litellm/.env
      cp config/litellm/config.example.yaml config/litellm/config.yaml

   2. Определите свой ключ Openai и поместите его внутрь config/litellm/.env как OPENAI_API_KEY . Вы можете получить свой ключ API здесь. Будьте уверены, вас не будет взиматься, если вы не используете API. Для получения более подробной информации о ценах, проверьте здесь.

3. Скопируйте файл .env.example :

   cp .env.example .env

4. Откройте файл .env в вашем любимом редакторе (Vim, Vscode, Emacs и т. Д.):

   vim .env # or emacs or vscode or nano

5. Обновите эти переменные:

   • SLACK_BOT_TOKEN , SLACK_APP_TOKEN и SLACK_SIGNING_SECRET - эти переменные необходимы для того, чтобы поговорить с Весппером на Slack. Пожалуйста, следуйте этому руководству, чтобы создать новое приложение Slack в вашей организации.

   • (Необязательно) SMTP_CONNECTION_URL - эта переменная необходима для того, чтобы пригласить новых участников в вашу организацию Vespper по электронной почте и позволить им использовать бот. Это не обязательно, если вы просто хотите проверить Весппер и играть с ним. Если вы хотите отправить приглашения членам вашей команды, вы можете использовать такую ​​услугу, как SendGrid/Mailgun. Следует следовать этой шаблоне: smtp://username:password@domain:port .

6. Запустите проект:

   docker compose up -d

Вот и все. Вы должны быть в состоянии посетить панель панели Vespper в http: // localhost: 5173. Просто создайте пользователя (с той же электронной почтой, что и в вашем Slack User) и начните настроить вашу организацию. Если что -то не работает для вас, обратитесь к нашим устранению неполадок или обратитесь к нам через наши каналы поддержки.

Следующими шагами является настройка вашей организации немного больше (подключить инструменты управления инцидентами, создать базу знаний и т. Д.). Перейдите в раздел Connect & Configure в наших документах для получения дополнительной информации?

Использование изображений DockerHub

Если вы хотите, вы можете вытащить наши изображения Docker из Dockerhub вместо клонирования репо и здания с нуля.

Чтобы сделать это, следуйте этим шагам:

1. Загрузить файлы конфигурации:

   curl https://raw.githubusercontent.com/vespper/vespper/main/tools/scripts/download_env_files.sh | sh

2. Следуйте шагам 2 и 5 выше, чтобы настроить прокси -сервер Litellm и ваш .env соответственно. А именно, вам нужно настроить свой ключ OpenAI на config/litellm/.env и настроить ваши учетные данные в корне .env .

3. Раскрутите среду, используя Docker Compose:

   curl https://raw.githubusercontent.com/vespper/vespper/main/tools/scripts/start.sh | sh

Вот и все ? Вы должны быть в состоянии посетить панель панели Vespper в http: // localhost: 5173.

Обновление Vespper? ‍♂️

1. Получите последние изменения:

   git pull

2. Восстановить изображения:

   docker-compose up --build -d

Развертывание ☁

Посетите наши примеры руководства, чтобы развернуть Vespper в вашем облаке.

Визуализировать базу знаний? ️

Мы используем ChromADB в качестве нашего векторного дБ. Мы также используем векторный администратор, чтобы увидеть проглатываемые документы. Чтобы использовать векторный администратор, просто запустите эту команду:

docker compose up vector-admin -d

Эта команда начинает вектор-админи в порту 3001. Перейдите к http: // localhost: 3001 и настройте свой локальный Chromadb. ПРИМЕЧАНИЕ. Поскольку вектор-админ работает внутри контейнера Docker, в поле «Хост» обязательно вставьте http://host.docker.internal:8000 вместо http://localhost:8000 . Это потому, что «Localhost» не ссылается на хост внутри самого контейнера.

Более того, в «API Header & Key» вам нужно поместить «X-Chroma-Token» в качестве заголовка и значение, которое у вас есть CHROMA_SERVER_AUTHN_CREDENTIALS .

Чтобы узнать, как использовать VectorAdmin, посетите документы.

Поддержка и обратная связь? ‍♀

В порядке предпочтения лучший способ общаться с нами:

• Обсуждения GitHub : внести вклад в идеи, запросы на поддержку и сообщать об ошибках (предпочтительно, поскольку существует статический и постоянный для других членов сообщества).
• Slack : поддержка сообщества. Нажмите здесь, чтобы присоединиться.
• В частном порядке : свяжитесь с [email protected]

Внесение вклад в Vespper ⛑

Если вы заинтересованы в внесении вклад в Vespper, проверьте наш файл CONTRIBUTING.md ? ? ‍♂️

Устранение неполадок ⚒

Если вы сталкиваетесь с какими -либо проблемами/ошибками/проблемами с Vespper, проверьте наше руководство по устранению неполадок. Мы стараемся регулярно обновлять его и исправлять некоторые из неотложных проблем там как можно скорее.

Более того, не стесняйтесь обращаться к нам на наших каналах поддержки.

Телеметрия?

По умолчанию Vespper автоматически отправляет базовую статистику использования из самостоятельных экземпляров на наш сервер через Posthog.

Это позволяет нам:

• Поймите, как используется Vespper, чтобы мы могли его улучшить.
• Отслеживайте общее использование для внутренних целей и внешней отчетности, например, для сбора средств.

Будьте уверены, собранные данные не передаются третьим лицам и не включают никакой конфиденциальной информации. Мы стремимся быть прозрачными, и вы можете просмотреть конкретные данные, которые мы собираем здесь.

Если вы предпочитаете не участвовать, вы можете легко отказаться, установив TELEMETRY_ENABLED=false внутри вашего .env .

Лицензия?

Этот проект лицензирован по лицензии Apache 2.0 - для получения подробной информации см. Файл лицензии.

Узнать больше ?

Ознакомьтесь с официальным веб -сайтом по адресу https://vespper.com для получения дополнительной информации.

Участники

Построен с ❤ от Dudu & Topaz

Дуду: Github, Twitter

Топаз: GitHub, Twitter