{"id":19247967,"url":"https://github.com/ahmad2b/cinematch","last_synced_at":"2026-04-29T22:43:24.061Z","repository":{"id":215668887,"uuid":"739474542","full_name":"ahmad2b/cinematch","owner":"ahmad2b","description":"AI Movie Recommendation Engine","archived":false,"fork":false,"pushed_at":"2024-01-06T05:03:18.000Z","size":30,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-05T05:25:26.322Z","etag":null,"topics":["aiohttp","gpt-4","openai","openai-api","postgresql","pydantic","pytest","python","requests","sqlalchemy","streamlit","tmdb-api"],"latest_commit_sha":null,"homepage":"https://cinematch-x.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmad2b.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-05T16:49:56.000Z","updated_at":"2024-04-27T12:19:06.000Z","dependencies_parsed_at":"2024-02-03T21:00:49.714Z","dependency_job_id":null,"html_url":"https://github.com/ahmad2b/cinematch","commit_stats":null,"previous_names":["ahmad2b/cinematch"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmad2b%2Fcinematch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmad2b%2Fcinematch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmad2b%2Fcinematch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmad2b%2Fcinematch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmad2b","download_url":"https://codeload.github.com/ahmad2b/cinematch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240339583,"owners_count":19785957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiohttp","gpt-4","openai","openai-api","postgresql","pydantic","pytest","python","requests","sqlalchemy","streamlit","tmdb-api"],"created_at":"2024-11-09T18:05:58.391Z","updated_at":"2025-10-26T05:02:49.697Z","avatar_url":"https://github.com/ahmad2b.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cinematch: AI Movie Recommendation Engine\n\nCinematch is an interactive movie recommendation system built using Streamlit and the OpenAI API. It leverages the power of AI to provide personalized movie recommendations based on user preferences.\n\n## Features\n\n- **User Interface**: Create a user-friendly interface for users to input their movie preferences and ratings.\n- **Database Connectivity**: Use database connectivity to fetch and display movie recommendations, along with relevant details such as genre, director, actors, etc.\n- **Secrets Management**: Implement secrets management to securely store and access API keys for interacting with the movie database.\n- **Deployment**: Deploy the application on a cloud platform such as Heroku for easy access.\n\n## Tech Stack\n\nThis project uses the following technologies:\n\n- **OpenAI API**: Used for AI functionalities.\n- **TMDB API**: An API for fetching movie data.\n\n- **Python**: The main programming language.\n- **Streamlit**: A Python library for creating web interfaces.\n- **Requests and aiohttp**: Python libraries for making HTTP requests.\n- **Pydantic**: A Python library for data validation and settings management.\n- **PostgreSQL (supabase)**: The database system.\n- **SQLAlchemy**: A Python SQL toolkit and ORM library.\n- **pytest**: A testing framework for Python.\n- **Git**: The version control system.\n- **Streamlit Cloud**: The cloud platform for deploying our Streamlit application.\n\n## Table of Contents\n\n- [Cinematch: AI Movie Recommendation Engine](#cinematch-ai-movie-recommendation-engine)\n  - [Features](#features)\n  - [Tech Stack](#tech-stack)\n  - [Table of Contents](#table-of-contents)\n  - [Installation](#installation)\n  - [Usage](#usage)\n  - [License](#license)\n\n## Installation\n\nThis project requires Python 3.8 or later. Clone the repository and install the dependencies:\n\n```sh\ngit clone https://github.com/ahmad2b/Cinematch.git\ncd Cinematch\npip install -r requirements.txt\n```\n\n## Usage\n\nTo start the application, run the following command in your terminal:\n\n```sh\nstreamlit run Home.py\n```\n\nThen, open your web browser and navigate to `http://localhost:8501` to start using Cinematch.\n\n## License\n\nThis project is licensed under the terms of the MIT license. See LICENSE for additional details.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmad2b%2Fcinematch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmad2b%2Fcinematch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmad2b%2Fcinematch/lists"}