ChatHub is a web application built with Django Channels that allows users to chat in hubs in real-time. With ChatHub, users can join different hubs and engage in conversations with other users simultaneously.
- Real-time chat functionality using WebSocket communication.
- Multiple hubs for users to join and participate in discussions.
- Simple and intuitive user interface for easy navigation and interaction.
To run ChatHub locally on your machine, follow these steps:
- Python (>=3.6)
- Django (>=3.2)
- Django Channels (>=3.0)
- Redis (for production deployments)
-
Clone the repository:
git clone https://github.com/ignatiusratemo26/chathub_v1.git
-
Navigate to the project directory:
cd chathub
-
Install the Python dependencies:
pip install -r requirements.txt
-
Configure the database settings in
chathub/settings.py
. -
Set up the Django Channels layer backend in
chathub/settings.py
for production deployments.
-
Apply migrations:
python manage.py migrate
-
Start the development server:
python manage.py runserver
-
Access ChatHub in your web browser at
http://localhost:8000
.
- Create an account or log in to an existing account.
- Browse the list of available hubs and join one.
- Start chatting with other users in the hub in real-time.
Contributions are welcome! If you'd like to contribute to ChatHub, please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature-name
). - Commit your changes (
git commit -am 'Add your feature description'
). - Push to the branch (
git push origin feature/your-feature-name
). - Create a new pull request.
- Django - The web framework used
- Django Channels - For real-time WebSocket communication