{"id":28992280,"url":"https://github.com/ghonijee/money-tracker-ai-agent","last_synced_at":"2026-05-11T07:49:04.804Z","repository":{"id":293177742,"uuid":"982523776","full_name":"ghonijee/money-tracker-ai-agent","owner":"ghonijee","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-10T04:42:50.000Z","size":269,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-10T05:23:44.560Z","etag":null,"topics":["agentic-ai","ai","fastapi","moneytracker","python","whatsapp-bot"],"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/ghonijee.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-05-13T02:45:00.000Z","updated_at":"2025-06-10T04:16:01.000Z","dependencies_parsed_at":"2025-05-14T04:39:16.130Z","dependency_job_id":"ebaefc60-4afc-43fd-b6a0-120240fc41d9","html_url":"https://github.com/ghonijee/money-tracker-ai-agent","commit_stats":null,"previous_names":["ghonijee/money-tracker-ai-agent"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ghonijee/money-tracker-ai-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghonijee%2Fmoney-tracker-ai-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghonijee%2Fmoney-tracker-ai-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghonijee%2Fmoney-tracker-ai-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghonijee%2Fmoney-tracker-ai-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghonijee","download_url":"https://codeload.github.com/ghonijee/money-tracker-ai-agent/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghonijee%2Fmoney-tracker-ai-agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261789330,"owners_count":23209779,"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":["agentic-ai","ai","fastapi","moneytracker","python","whatsapp-bot"],"created_at":"2025-06-25T02:08:56.334Z","updated_at":"2026-05-11T07:48:59.783Z","avatar_url":"https://github.com/ghonijee.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Expense Tracker AI Agent\n\nExpense Tracker AI Agent is an AI-powered backend service that helps users track, categorize, and analyze their expenses and incomes via natural language interfaces, including WhatsApp integration. The agent leverages LLMs to interpret user queries, extract structured data, and interact with a transaction database.\n\n## Tech Stack\n\n- **Python 3.12**\n- **FastAPI** – Web API framework\n- **SQLAlchemy** – ORM for database access\n- **Alembic** – Database migrations\n- **OpenAI / LLMs** – Natural language processing\n- **heyoo** – WhatsApp API integration\n- **Granian (uv)** – ASGI server\n- **Docker** – Containerization\n- **pytest** – Testing framework\n- **Jinja2** – Prompt templating\n\n## How to Run\n\n### 1. Clone the Repository\n\n```sh\ngit clone https://github.com/ghonijee/expense-tracker-ai-agent.git\ncd expense-tracker-ai-agent\n```\n\n### 2. Set Up Environment Variables\n\nCopy `.env.example` to `.env` and fill in the required values (e.g., database URL, OpenAI key, WhatsApp credentials):\n\n```sh\ncp .env.example .env\n```\n\n### 3. Install Dependencies\n\nYou can use `uv` (recommended) or `pip`:\n\n```sh\n# Using uv\nuv sync\n\n# Or using pip\npip install -r requirements.txt\n```\n\n### 4. Run Database Migrations\n\n```sh\nalembic upgrade head\n```\n\n### 5. Start the Application\n\n#### Using Docker\n\n```sh\ndocker-compose up --build\n```\n\n#### Or Locally\n\n```sh\n# Using uv\nuv run granian --interface asgi src.main:app --reload\n\n# Or using uvicorn\nuvicorn app.main:app --reload\n```\n\n### 6. Run Tests\n\n```sh\npytest\n```\n\n## Call to Action\n\nReady to automate your expense tracking with AI?\n\n- Try out the API and connect your WhatsApp to start managing your finances smarter!\n- Star this repo if you find it useful.\n- Open an issue for feedback or feature requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghonijee%2Fmoney-tracker-ai-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghonijee%2Fmoney-tracker-ai-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghonijee%2Fmoney-tracker-ai-agent/lists"}