huly-selfhost  by hcengineering

Self-hosting setup for Huly collaboration platform

created 1 year ago
2,571 stars

Top 18.6% on sourcepulse

GitHubView on GitHub
Project Summary

This repository provides a self-hostable deployment of Huly, a communication platform offering text, audio, and video chat with AI-powered features. It targets users who need a private, on-premises solution for team collaboration and communication, leveraging Docker Compose for simplified setup.

How It Works

Huly is architected as a collection of microservices orchestrated via Docker Compose. Key components include a front-end interface, an account service for authentication (supporting OIDC and GitHub OAuth), a transactor service, a mail service for notifications (SMTP or SES), a "Love" service for real-time audio/video powered by LiveKit, and an AI service for chatbot functionalities and translation, integrating with OpenAI.

Quick Start & Requirements

  • Install: Clone the repository and run ./setup.sh.
  • Prerequisites: Ubuntu 24.04 (recommended), Nginx, Docker, Node.js (for VAPID keys).
  • Hardware: Minimum 2 vCPUs and 4GB RAM recommended due to resource intensity.
  • Configuration: Requires generating VAPID keys for push notifications and configuring email (SMTP/SES) and AI (OpenAI) services via environment variables in docker-compose.yaml.
  • Docs: https://github.com/hcengineering/huly-selfhost

Highlighted Details

  • Real-time audio/video calls powered by LiveKit.
  • AI chatbot for text translation and virtual office support.
  • Supports OpenID Connect and GitHub OAuth for authentication.
  • Option to disable public sign-ups, enabling invite-only access.
  • Configurable email notifications via SMTP or Amazon SES.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels (like Discord/Slack) are provided in the README.

Licensing & Compatibility

The repository does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The README notes that Huly is resource-heavy, recommending specific hardware. It also mentions that SES_URL is not supported in newer versions, requiring MAIL_URL instead. Disabling sign-ups requires careful initial account creation.

Health Check
Last commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
20
Star History
335 stars in the last 90 days

Explore Similar Projects

Starred by Dan Abramov Dan Abramov(Core Contributor to React) and Jared Palmer Jared Palmer(Ex-VP of AI at Vercel; Founder of Turborepo; Author of Formik, TSDX).

retro-board by antoinejaussoin

0.1%
797
AI-powered agile retrospective board for engineering teams
created 9 years ago
updated 8 months ago
Feedback? Help us improve.