MeetHub

MeetHub is an open source event management system built with Python and Django web framework. It helps users create, discover, and manage events easily.

Features

• 📅 Event Creation and Management
• 🔔 Real-time Notifications System
• 💬 Event Comments and Discussions
• 👥 User Profiles
• 🔍 Event Discovery
• 📱 Responsive Design

Screenshots

Installation

Prerequisites

• Python 3.6+
• pip
• virtualenv (recommended)

Setup

1. Clone the repository

   git clone https://github.com/iyanuashiri/meethub.git
   cd meethub

2. Create and activate virtual environment

   python -m venv venv
   source venv/bin/activate  # On Windows use: venv\Scripts\activate

3. Install dependencies

   pip install -r requirements.txt

4. Configure environment variables

   cp .env.example .env
   # Edit .env with your settings

5. Run migrations

   python manage.py migrate

6. Start the development server

   python manage.py runserver

Visit http://localhost:8000 in your browser.

Roadmap

• [ ] Add comprehensive test suite
• [ ] Implement REST API
• [ ] Add threaded comments
• [ ] Add location-based event exploration
• [ ] Implement social authentication
• [ ] Add event categories and tags
• [ ] Enable event sharing on social media

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.