Antimatter
Първи стъпки

Пуснете Antimatter на собствения си сървър

Един файл, три команди, около десет минути: Antimatter с базата данни, хранилището за файлове и услугата за GIF анимации, на всеки Linux сървър с Docker.

Готови за работа за десет минути

Нужен ви е Linux сървър с Docker и приставката му Compose, с поне 2 процесорни ядра и 4 GB памет.

1. Изтеглете compose файла

$ mkdir antimatter && cd antimatter
$ curl -fsSLO https://antimatter.chat/compose.yaml

2. Създайте настройките със случайни пароли

$ cat > .env <<EOF
SITE_URL=http://localhost:8065
POSTGRES_PASSWORD=$(openssl rand -hex 24)
S3_SECRET_KEY=$(openssl rand -hex 24)
GIFS_API_KEY=$(openssl rand -hex 24)
EOF

Задайте в SITE_URL адреса, който хората ще използват, например http://192.168.1.20:8065 в локална мрежа.

3. Стартирайте

$ docker compose up -d

Първото стартиране отнема минута-две, докато се създаде базата данни. След това отворете SITE_URL в браузъра си и създайте акаунт: първият акаунт става системен администратор, а съветникът за настройка ще ви преведе през създаването на първата ви общност.

Със собствен домейн и HTTPS

Насочете DNS запис на домейна си към сървъра, отворете портове 80 и 443 и добавете домейна в .env:

$ cat >> .env <<EOF
DOMAIN=chat.example.com
EOF
$ sed -i 's|^SITE_URL=.*|SITE_URL=https://chat.example.com|' .env
$ docker compose --profile https up -d

Caddy получава сертификат от Let's Encrypt и го подновява автоматично.

Какво се стартира

  • antimatter: сървърът с приложенията си (бележки, бели дъски, гласови канали, обаждания, анкети и останалите). Той не пази нищо на диска: настройките му са в базата данни, а файловете — в услугата за съхранение, така че контейнерът може да бъде заменен по всяко време.
  • postgres: базата данни.
  • files: RustFS, хранилище, съвместимо с S3, за качените файлове.
  • gifs: услугата на Antimatter за GIF анимации и стикери, с начален пакет стикери.
  • https: Caddy, само с профила https.

Базата данни, хранилището и услугата за GIF анимации са в частна мрежа, до която има достъп само Antimatter.

Ако панелът за избор на GIF анимации остава празен, отворете Системна конзола › Приставки › GIFs и задайте за URL адрес на услугата http://gifs:8080/v2, а за API ключ — стойността на GIFS_API_KEY от вашия .env.

Обновяване и резервни копия

# обновяване до най-новите образи
$ docker compose pull && docker compose up -d
# резервно копие на базата данни
$ docker compose exec postgres pg_dump -U antimatter antimatter > antimatter.sql

Правете резервно копие и на тома files или репликирайте хранилището с произволен S3 инструмент. За инсталация с nginx и собствени сертификати вижте файловете за продукционна среда в antimatter-docker.

С архив на издание

  1. Създайте база данни и потребител в PostgreSQL.
  2. Разархивирайте архива (antimatter-<os>-<arch>.tar.gz), например в /opt/antimatter, и насочете SqlSettings.DataSource в config/config.json (или променливата на средата AM_SQLSETTINGS_DATASOURCE) към базата данни.
  3. Стартирайте сървъра с bin/antimatter като непривилегирован потребител и отворете http://localhost:8065. Първият създаден акаунт става системен администратор.

bin/amctl управлява работещ сървър от командния ред (bin/amctl --local на самия сървър, при включен ServiceSettings.EnableLocalMode).

Следващи стъпки

  • Обаждания: отворете порта за обаждания (по подразбиране UDP и TCP 8443), за да достига гласът и видеото до сървъра.
  • Имейл: настройте SMTP за поканите и известията.
  • AI: добавете модел в настройките на агентите; работи всеки API, съвместим с OpenAI, включително сървър, който поддържате сами.
  • Реч и превод: насочете транскрипцията на обажданията, четенето на глас и автоматичния превод към модели за разпознаване на реч, синтез на реч и превод, които поддържате сами.