Skip to content

This is a Python/Django based event management system. A meetup clone.

License

Notifications You must be signed in to change notification settings

iyanuashiri/meethub

Repository files navigation

MeetHub

Codacy Badge

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

Click to view screenshots

Explore Page

explore page

Event Creation

create event

Notifications

notifications

User Profile

profile

Login Page

login

Installation

Prerequisites

  • Python 3.6+
  • pip
  • virtualenv (recommended)

Setup

  1. Clone the repository
git clone https://github.com/iyanuashiri/meethub.git
cd meethub
  1. Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate
  1. Install dependencies
pip install -r requirements.txt
  1. Configure environment variables
cp .env.example .env
# Edit .env with your settings
  1. Run migrations
python manage.py migrate
  1. 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.