HK Event Search

python_hk_event_search allows you to search for Hong Kong events from various event platforms with a single command. It filters out events that occur during working hours and the topics you are not interested in, saving you time and effort.

Features

• Fetch events from Eventbrite, Luma, Meetup, GDG HK, HKU, CityU, PolyU, and HKBU.
• Filter for events during non-working hours, in person, free, not sold out, and the categories you are interested in.
• Filter out topics by keywords in their titles by modifying title_filter_config in the main.py.
• Easy to use and extend.

Usage

Run the script (see Installation below for detail):

python main.py

The print result will be like

=============== CityU ===============
Title: CityUHK MBA Masterclass & Info Session in Shanghai (11 January 2025)
Date: 11 Jan 2025 (Sat)
Time: 2:30 PM - 5:30 PM
Venue: The Westin Bund Center Shanghai
URL: https://cap.cityu.edu.hk/postpublic.aspx?id=M10k0520e245412O738312
----------------------------------------
=============== PolyU ===============
Title: 30th Annual Graduate Education and Graduate Student Research Conference in Hospitality & Tourism
Start Date: 2025-01-02 08:00:00, Thursday
End Date  : 2025-01-04 18:00:00, Saturday
URL: https://www.polyu.edu.hk/en/events/2025/1/20250102-30th-Annual-Graduate-Education-and-Graduate-Student-Research-Conference

=============== hku ===============
Title: [GUIDED TOUR 導賞] Perckhammer’s Peking: A Photographic Documentation of China’s Capital City in the 1920s 京城舊影：1920年代奧地利攝影家佩克哈默的攝影紀錄
Date: 26 Jan - 26 Jan 2025 (Sunday)
Time: 15:30-15:50
Venue: Drake Gallery, 1/F Fung Ping Shan Building, University Museum and Art Gallery, The University of Hong Kong, 90 Bonham Road, Pokfulam, Hong Kong  
URL: http://hkuems1.hku.hk/hkuems/ec_hdetail.aspx?guest=Y&UEID=97992
----------------------------------------
=============== Eventbrite ===============
Title: HKU MBA Open House
Start Date: 2025-01-18 02:30:00, Saturday
End Date  : 2025-01-18 17:30:00, Saturday
URL: 8 Connaught Place, Hong Kong SAR China, HKI
URL: https://www.eventbrite.com/e/hku-mba-open-house-tickets-1118454901719

Installation

To get started, clone the repository and install the required dependencies:

git clone https://github.com/codeHui/python_hk_event_search.git
cd python_hk_event_search

Init Environment using UV

To initialize the environment using UV from the pyproject.toml file:

uv sync
uv run python main.py

Init Environment using Conda (Recommend UV, not Conda)

To initialize the environment using Conda from the environment.yml file:

conda env create -f environment.yml
conda activate python_hk_event_search
python main.py

If you are Running in VS Code

Make sure you have selected the correct Python interpreter (e.g., python_hk_event_search),
Show and Run Commands (Ctrl + SHift +P ) -> Python: Select Interpreter

Other conda command you may need

Note: If you see an error asking to run 'conda init' before 'conda activate', run:

conda init

then restart your shell.

Windows PowerShell users may need to run:

conda init powershell

then close and reopen PowerShell, and run:

conda activate python_hk_event_search

Updating the environment

conda deactivate python_hk_event_search
conda env remove -n python_hk_event_search
conda env create -f environment.yml
conda activate python_hk_event_search

Contributing

Please feel free give it a star, fork the repository, and send pull requests. Join the discussion in the Discussions tab.

License

This project is licensed under the MIT License and free to use.

Contact

For any questions or suggestions, please open an issue or start a discussion.

If you like this project, please give it a star!