{"id":28826474,"url":"https://github.com/wtfdevansh/crediguide","last_synced_at":"2026-05-05T13:39:16.900Z","repository":{"id":299775788,"uuid":"1003333641","full_name":"wtfdevansh/CrediGuide","owner":"wtfdevansh","description":"llm agent which can recommend the credit card based on score and usage give respone in structure way you can read readme for setup and can access our model using website and whatsapp ","archived":false,"fork":false,"pushed_at":"2025-06-18T08:30:26.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-18T08:36:52.086Z","etag":null,"topics":["agent","json","langchain","openai","pydantic","python"],"latest_commit_sha":null,"homepage":"","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/wtfdevansh.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,"zenodo":null}},"created_at":"2025-06-17T01:54:44.000Z","updated_at":"2025-06-18T08:36:13.000Z","dependencies_parsed_at":"2025-06-18T08:47:49.170Z","dependency_job_id":null,"html_url":"https://github.com/wtfdevansh/CrediGuide","commit_stats":null,"previous_names":["wtfdevansh/crediguide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wtfdevansh/CrediGuide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtfdevansh%2FCrediGuide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtfdevansh%2FCrediGuide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtfdevansh%2FCrediGuide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtfdevansh%2FCrediGuide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wtfdevansh","download_url":"https://codeload.github.com/wtfdevansh/CrediGuide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtfdevansh%2FCrediGuide/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260676930,"owners_count":23045115,"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":["agent","json","langchain","openai","pydantic","python"],"created_at":"2025-06-19T03:04:35.330Z","updated_at":"2026-05-05T13:39:16.895Z","avatar_url":"https://github.com/wtfdevansh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Credi Guide 💳\n\nCredi Guide is a user-friendly chatbot designed to help you find the perfect credit card based on your financial profile and spending habits. Interact with our intelligent assistant to receive personalized recommendations.\n\n## Features\n\n*   Interactive chatbot interface powered by Streamlit.\n*   Personalized credit card recommendations using a Langchain agent.\n*   Detailed information for each recommended card:\n    *   Card Name and Issuer\n    *   Card Image\n    *   Rewards Summary\n    *   Annual Fee\n    *   Reason for Recommendation\n*   Clear and structured presentation of recommendations.\n\n## Technologies Used\n\n*   Python\n*   Streamlit (for the web application)\n*   Langchain (for the AI agent and logic)\n*   Langchain-OpenAI (for interacting with OpenAI models)\n*   Pydantic (for data validation and schema)\n*   Dotenv (for environment variable management)\n\n## Setup and Installation\n\n1.  **Clone the repository:**\n    ```bash\n    git clone \u003cYOUR_REPOSITORY_URL\u003e # Replace with the actual URL\n    cd \u003cYOUR_REPOSITORY_DIRECTORY\u003e   # Replace with the actual directory name\n    ```\n2.  **Create and activate a virtual environment (recommended):**\n    ```bash\n    python -m venv venv\n    source venv/bin/activate  # On Windows use `venv\\Scripts\\activate`\n    ```\n3.  **Install dependencies:**\n    ```bash\n    pip install -r requirements.txt\n    ```\n4.  **Set up environment variables:**\n    Create a file named `.env` in the root directory of the project and add your OpenAI API key:\n    ```env\n    OPENAI_API_KEY=\"your_openai_api_key_here\"\n    ```\n    Replace `\"your_openai_api_key_here\"` with your actual OpenAI API key.\n\n## How to Run\n\n*   Ensure your virtual environment is activated and you are in the project's root directory.\n*   Run the Streamlit application using the following command:\n    ```bash\n    streamlit run app.py\n    ```\n*   Open your web browser and navigate to the local URL provided by Streamlit (usually `http://localhost:8501`).\n\n## Access using whatsapp\n\n[qr code](https://drive.google.com/file/d/19gqYk-wESRacfz-aiskbgPJ473pQijSh/view?usp=sharing)\n\n## Access using web\n[url](https://wtfdevansh-crediguide-app-dpt10d.streamlit.app/)\n\n\n## Project Structure\n\n```\n.\n├── app.py                # Main Streamlit application file\n├── llm_agent.py          # Defines the Langchain agent and its tools\n├── card_agent/           # Module for card recommendation logic\n│   ├── recommender.py    # Core recommendation engine\n│   ├── data_loader.py    # Loads card data\n│   └── ...\n├── data/\n│   └── sampleData.json   # Sample data for credit cards\n├── requirements.txt      # Project dependencies\n├── schema/               # Pydantic schemas for data validation\n│   └── schema.py\n├── assets/               # Images and static files for the UI\n└── README.md             # This file\n```\n\n## Contributing\n\n*   Contributions are welcome! If you have suggestions for improvements or find any issues, please feel free to:\n    *   Open an issue on the project's GitHub page.\n    *   Fork the repository, make your changes, and submit a pull request.\n    \n \n## Demo video\n[whatsapp demo](https://drive.google.com/file/d/1GAk_eXgrWctWkaSwj4SX_yDt7jkcmYxx/view?usp=sharing)\n\n[web demo](https://drive.google.com/file/d/1HykOXT5uiu6Jmet2DIzEeSv7nyt3bTKk/view?usp=sharing)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtfdevansh%2Fcrediguide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwtfdevansh%2Fcrediguide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtfdevansh%2Fcrediguide/lists"}