5 минут до первого сообщения

Начните общаться
уже сегодня

Веб-клиент открывается в любом браузере, сервер разворачивается парой команд, а открытый API ждёт ваши мобильные приложения. Выбирайте свой путь.

Готово к работесхема БД создана автоматически
altgram — 5 минут до запуска
# установка$ cd altgram # дистрибутив сервера$ pip install -r requirements.txt# конфигурация$ ALTGRAM_DB_HOST=ваш-postgres# запуск$ python run.py --ssl сервер запущен на :8070
HTTPS из коробкисертификат сгенерирован
Три способа

Как вам удобнее

От «нажал и общаешься» до полного контроля над инфраструктурой.

В браузере

Никаких установок: веб-клиент работает и на десктопе, и на телефоне. Откройте — и вы уже в чате.

desktop · mobile web

Свой сервер

Python и PostgreSQL — вот и весь стек. Четыре шага, и мессенджер живёт на вашей машине, а данные — только у вас.

python · postgresql · :8070

Мобильные приложения

Нативные клиенты строятся на открытом API — авторизация, чаты, звонки и медиа задокументированы для команд разработки.

REST · WebSocket · WebRTC
Self-hosted

Установка сервера

Схема базы создаётся автоматически, администратор — уже внутри. Ваша задача — четыре шага.

1

Подготовьте окружение

Python 3.11+ и работающий PostgreSQL. Больше ничего — ни Docker, ни Kubernetes не обязательны.

2

Поставьте зависимости

pip install -r requirements.txt — одна команда, и всё готово к запуску.

3

Настройте .env

Укажите адрес вашей базы PostgreSQL. Схема таблиц развернётся сама при первом старте.

4

Запустите с HTTPS

python run.py --ssl — и открывайте https://ваш-хост:8070. Сертификат для звонков сгенерируется автоматически.

altgram — установка
# 1. Окружение: Python 3.11+ и PostgreSQL $ python --version Python 3.11.9 # 2. Зависимости $ pip install -r requirements.txt # 3. Конфигурация (.env) $ ALTGRAM_DB_HOST=ваш-postgres # 4. Запуск с HTTPS $ python run.py --ssl Altgram на https://ваш-хост:8070
Что понадобится

Требования

Altgram скромен в аппетитах — подойдёт даже небольшая виртуалка.

КомпонентТребование
Python3.11 или новее
PostgreSQL14 или новее — схема БД создаётся автоматически
ОЗУот 1 ГБ
Дискпод ваши файлы и медиа — считайте по объёму команды
Порт8070 TCP
HTTPSобязателен для звонков и камеры — самоподписанный сертификат генерируется автоматически
Разработчикам

API для разработчиков

Версионированный REST на /api/v1 плюс WebSocket-события: JWT-токены на 7 дней, multipart-загрузка медиа. В комплекте сервера — MOBILE_API.md и API_CONTRACT.md с полным описанием, а интерактивный Swagger живёт на /docs.

  • Авторизация JWTЛогин, refresh и список сеансов с отзывом — из коробки.
  • Realtime по WebSocketСообщения, реакции, typing и онлайн-статусы приходят мгновенно.
  • Загрузка медиаMultipart до 200 МБ: фото с превью, видео, аудио, документы.
  • Сигналинг WebRTCВсё для звонков 1:1 и конференций — включая приглашения по ссылке.
api/v1 — эндпоинты
POST /api/v1/auth/login # → JWT, 7 дней GET /api/v1/chats POST /api/v1/chats/{id}/messages GET /api/v1/messages/search?q=… # русский FTS POST /api/v1/files/upload # multipart ≤ 200 МБ POST /api/v1/stories # сторис на 24 часа POST /api/v1/calls # WebRTC-сигналинг POST /api/v1/calls/{id}/invite GET /api/v1/sessions # сеансы и отзыв WS wss://host/ws?token=…
Мобильная разработка

Android и iOS

Честно: готовых приложений в сторах пока нет. Зато API открыт и задокументирован — ваша команда соберёт нативный клиент на привычном стеке.

Android

Kotlin + OkHttp/Retrofit для REST и WebSocket, официальный WebRTC SDK для звонков — всё стандартно ложится на API Altgram. MOBILE_API.md проведёт от логина до сигналинга.

Kotlin · Retrofit · WebRTC SDK

iOS

Swift + URLSession для сети и WebRTC.framework для аудио- и видеозвонков. JWT-авторизация, multipart-загрузка и WebSocket-события описаны в контракте API — без сюрпризов.

Swift · URLSession · WebRTC.framework

Разверните свой Altgram сегодня

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