Skip to content

interchatapp/InterChat

Repository files navigation

interchat logo

InterChat

Connect Discord communities seamlessly with real-time cross-server communication

Maintainability Version Servers Discord

Add to DiscordDocumentationSupport ServerVote for Us

Support us on Ko-fi

📋 About InterChat

InterChat is a powerful Discord bot that breaks down the walls between communities by enabling real-time cross-server communication. Whether you're looking to build topic-focused communities, connect with like-minded servers, or simply expand your server's reach, InterChat provides the tools to make it happen.

With InterChat, messages flow naturally between connected servers, creating vibrant, engaged communities that transcend individual Discord servers. Our hub-based system allows you to join existing communities or create your own, while our call feature enables quick one-to-one server connections.

✨ Key Features

  • 🌐 Cross-Server Communication

    • Hub System: Join or create themed communities with multiple connected servers
    • Call Feature: Quick temporary one-to-one connections between servers
    • Real-time Messaging: Messages delivered instantly across all connected servers
    • Rich Media Support: Share images, embeds, and reactions across servers
  • 🛡️ Advanced Security & Moderation

    • Smart Content Filtering: Block inappropriate content automatically
    • Anti-Spam Protection: Keep conversations clean and relevant
    • Comprehensive Logging: Track cross-server activity
    • Moderation Tools: Manage users across server boundaries
  • 🎮 Intuitive Dashboard

    • Visual Hub Management: Create, configure, and monitor hubs
    • Server Insights: Understand connection activity
    • Mobile Compatibility: Manage your communities from any device
  • 🔧 Customization Options

    • Custom Welcome Messages: Personalize the experience for new members
    • Hub Rules: Set specific guidelines for your community
    • Flexible Permissions: Control who can do what in your hubs
    • Multiple Languages: InterChat supports various languages

🚀 Getting Started

Adding InterChat to Your Server

  1. Invite the Bot: Visit interchat.tech/invite
  2. Run Setup: Type /setup in your server to start the guided setup process
  3. Choose Your Path:
    • Join a Hub: Use [interchat.tech/hubs] to find and join existing cross-server groups
    • Create a Hub: Use /hub create to start your own community
    • Quick Connect: Use /call for one-to-one server connections

Basic Commands

/setup - Start the guided setup process
/hub create - Create your own hub
/connect - Connect a channel to a hub
/call - Start a direct call with another server
/hangup - End an active call
/vote - Vote for InterChat and unlock perks
/help - View all available commands

🔧 Required Permissions

InterChat requires the following permissions to function properly:

  • Manage Webhooks - Essential for message delivery
  • Send Messages - To relay messages between servers
  • Manage Messages - For moderation features
  • Embed Links - For rich content display
  • Read Messages - To process messages for relay
  • Use External Emojis - For a better user experience

💻 Self-Hosting

# Clone the repository
git clone https://github.com/interchatapp/InterChat.git

# Install dependencies
cd interchat
npm install

# Configure environment
# Edit .env with your credentials

npx prisma generate
npx prisma db push # sync database schema


npm run build
npm run sync:commands --private --public
npm run sync:emojis
npm run locale-types

# Start development server
npm run dev

# Or production mode
npm start

🌐 Links & Resources

🤝 Contributing

We welcome all contributions! Here's how you can help:

  1. 🐛 Report bugs
  2. 💡 Suggest features
  3. 📝 Improve documentation
  4. 🌍 Help with translations
  5. 💻 Submit pull requests

Read our Contributing Guidelines to get started.

📜 License

InterChat is licensed under GNU AGPL-3.0

💖 Contributors


Made with ❤️ by the InterChat Team