Hugging Face's logo

Spaces:
LazyHuman
/
MAL_Agent
Sleeping

App Files Community
MAL_Agent / README.md
Kunal Gupta
Update README.md
b4b1660 unverified
preview code
|
raw
history blame contribute delete
3.05 kB
metadata
title: MAL Agent
emoji: 🚀
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
  - streamlit
pinned: false
short_description: MyAnimeList Based Agent
license: mit

MAL Agent 🚀

A Streamlit-powered assistant for managing your MyAnimeList anime list, discovering new anime, and getting recommendations—all in a friendly chat interface.

Features

  • MyAnimeList Management:
    • View, add, and remove anime from your personal MAL list.
    • Filter your list by status (Watching, Completed, etc.).
  • Anime Recommendations:
    • Get personalized anime suggestions.
    • Display recommendations as visually appealing cards.
  • Web Search:
    • Search for additional anime info using DuckDuckGo.
  • Watch Links:
    • Get streaming links exclusively from HiAnime.
  • Secure Authentication:
    • OAuth2 login with your MAL account.

Screenshots

Login

Homepage

My Anime List Query

Getting Started

1. Clone the Repository 

# Using PowerShell
git clone https://github.com/yourusername/MAL-Agent.git
cd MAL_Agent

2. Set Up Environment Variables

Copy example.env to .env and fill in your API keys and MAL credentials:

Copy-Item example.env .env

Edit .env and provide your keys:

GEMINI_API_KEY=your_gemini_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key
MAL_CLIENT_ID=your_mal_client_id
MAL_CLIENT_SECRET=your_mal_client_secret
MAL_REDIRECT_URI=http://localhost:8080/callback
MAL_PORT=8080

3. Install Dependencies 

pip install -r requirements.txt

4. Run the App 

streamlit run src/streamlit_app.py

The app will be available at http://localhost:8501.

Project Structure 

MAL_Agent/
├── .env
├── Dockerfile
├── README.md
├── requirements.txt
├── src/
│   ├── agent.py
│   ├── auth.py
│   ├── streamlit_app.py
│   └── tools.py

Docker

You can also run the app in Docker:

docker build -t mal-agent .
docker run -p 8501:8501 --env-file .env mal-agent

Important Note

This app can only be run locally.

Due to the way MyAnimeList OAuth and PKCE authentication works, you must run this app on your own machine (localhost). Hosting on Streamlit Community Cloud or other remote servers is not supported for full authentication functionality.

License

MIT

Credits

Support Me

If you like this project, consider supporting me on Ko-fi!

ko-fi