Skip to content

A single search app for movies + anime that returns metadata, streaming availability, AI-powered summaries & recommendations, and tools to build watchlists and watch parties.

License

Notifications You must be signed in to change notification settings

nova-cortex/Novara

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Novara Logo Novara

License: MIT Status: Active Version: 1.0.0

Novara Banner

πŸ–Ό Screenshot

GUI Interface

GUI Interface


πŸ“Ή Prototype

[πŸ“Œ View this Pin on Pinterest](https://pin.it/obS45cnFP)

Novara Prototype Video


πŸŽ‰ What’s New in v1.0.0

  • Initial Release
    • Novara is launched as a comprehensive entertainment hub.
    • Seamless integration with Jikan API for anime data and OMDb API for movie data.
    • Gemini API integration for personalized recommendations.

✨ All Features

  • Anime & Movie Search: Discover a vast library of anime and movies.
  • Personalized Recommendations: Get tailored suggestions powered by Gemini AI.
  • Watchlist Management: Keep track of your favorite titles.
  • Detailed Information: Access comprehensive details for each anime and movie.
  • User-Friendly Interface: Enjoy a clean and intuitive design.

πŸ“ Folder Structure

Novara/
β”œβ”€β”€ LICENSE
β”œβ”€β”€ pyproject.toml
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ novara-banner.jpg
β”‚   β”œβ”€β”€ novara-logo.png
β”‚   └── screenshots/
β”‚       └── screenshot.png
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ Blueprint.docx
β”‚   β”œβ”€β”€ CHANGELOG.md
β”‚   β”œβ”€β”€ CODE_OF_CONDUCT.md
β”‚   β”œβ”€β”€ CONTRIBUTING.md
β”‚   β”œβ”€β”€ README.md
β”‚   β”œβ”€β”€ SECURITY.md
β”‚   β”œβ”€β”€ STATUS.md
β”‚   └── USAGE.md
└── src/
    β”œβ”€β”€ .env
    β”œβ”€β”€ main.py
    └── app/
        β”œβ”€β”€ __init__.py
        β”œβ”€β”€ clients/
        β”‚   β”œβ”€β”€ __init__.py
        β”‚   β”œβ”€β”€ googlegemini.py
        β”‚   β”œβ”€β”€ jikan.py
        β”‚   └── omdb.py
        β”œβ”€β”€ ui_components/
        β”‚   β”œβ”€β”€ anime_details.py
        β”‚   β”œβ”€β”€ cards.py
        β”‚   β”œβ”€β”€ movie_details.py
        β”‚   β”œβ”€β”€ styles.py
        β”‚   └── watchlist_display.py
        └── utils/
            β”œβ”€β”€ api_keys.py
            └── watchlist.py

πŸ•Ή Usage

Prerequisites

  • Python 3.8+
  • pip (Python package installer)
  • API Keys for Jikan, OMDb, and Google Gemini (refer to src/app/utils/api_keys.py for setup)

Installation

  1. Clone the repository:

    git clone https://github.com/nova-cortex/novara.git
    cd novara
  2. Create a virtual environment (recommended):

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install dependencies:

    pip install -r requirements.txt
  4. Set up API Keys:

    • Create a .env file in the src directory.
    • Add your API keys as environment variables. Example:
      OMDB_API_KEY=your_omdb_api_key
      GEMINI_API_KEY=your_gemini_api_key
      
  5. Run the application:

    python src/main.py

For more detailed documentation, see our USAGE.md


🀝 Contributing

We welcome contributions to Novara! Please see our Contributing Guide for details on how to get started.


Code of Conduct

This project adheres to the Code of Conduct. Please read it before contributing.


πŸ“‹ Roadmap

  • Enhance AI recommendation engine
  • Add more content categories (e.g., books, games)

See the open issues for a full list of proposed features and known issues.


πŸ“ Changelog

All notable changes to this project are documented in CHANGELOG.md.


πŸ“„ License

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


πŸ™ Acknowledgments

  • The Jikan API for anime data.
  • The OMDb API for movie data.
  • Google Gemini for powerful AI recommendations.
  • All contributors and users who support Novara.

πŸ“ž Support


πŸ”— Connect

πŸ“ Writing & Blogging

Hashnode Medium

πŸ’Ό Professional

Website ukr-projects cyberx-projects contro-projects LinkedIn Main Channel

🌐 Social

Twitter Instagram Tech Channel Telegram Reddit


Made with ❀️ by Nova Cortex

About

A single search app for movies + anime that returns metadata, streaming availability, AI-powered summaries & recommendations, and tools to build watchlists and watch parties.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Languages