{"id":27112419,"url":"https://github.com/kingflow-23/expense-tracker","last_synced_at":"2026-05-09T09:06:31.306Z","repository":{"id":285037790,"uuid":"956343115","full_name":"Kingflow-23/Expense-Tracker","owner":"Kingflow-23","description":"A personal finance tracker where users can log and categorize their expenses.","archived":false,"fork":false,"pushed_at":"2025-03-29T03:36:21.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T01:58:56.687Z","etag":null,"topics":["backend","fastapi","frontend","sqlalchemy","streamlit"],"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/Kingflow-23.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":"2025-03-28T05:06:19.000Z","updated_at":"2025-03-29T03:40:46.000Z","dependencies_parsed_at":"2025-03-29T04:35:23.132Z","dependency_job_id":null,"html_url":"https://github.com/Kingflow-23/Expense-Tracker","commit_stats":null,"previous_names":["kingflow-23/expense-tracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kingflow-23/Expense-Tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kingflow-23%2FExpense-Tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kingflow-23%2FExpense-Tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kingflow-23%2FExpense-Tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kingflow-23%2FExpense-Tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kingflow-23","download_url":"https://codeload.github.com/Kingflow-23/Expense-Tracker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kingflow-23%2FExpense-Tracker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265947508,"owners_count":23853382,"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":["backend","fastapi","frontend","sqlalchemy","streamlit"],"created_at":"2025-04-07T01:59:07.039Z","updated_at":"2026-05-09T09:06:31.273Z","avatar_url":"https://github.com/Kingflow-23.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Project Name\n\n#### 💰📊 Expense Tracker – Take Control of Your Finances!\n\n## 📌 Overview\nThis project is a **user management system** that allows users to **sign up, log in, update their profile, and log out** securely. It utilizes **FastAPI** for the backend and **Streamlit** for the frontend, ensuring a seamless and modern user experience.\n\n## 🚀 Features\n- User authentication (signup, login, logout)\n- Profile management (update user details)\n- Secure API with JWT authentication\n- Streamlit-powered frontend for a smooth UI\n\n## 🛠️ Technologies Used\n- **Backend:** FastAPI, SQLAlchemy, Pydantic\n- **Frontend:** Streamlit\n- **Database:** PostgreSQL (or SQLite for development)\n- **Authentication:** JWT Tokens\n\n## 📂 Project Structure\n```\n📦 project-directory\n ┣ 📂 backend\n ┃ ┣ 📜 main.py          # FastAPI application\n ┃ ┣ 📜 models.py        # Database models\n ┃ ┣ 📜 routes.py        # API endpoints\n ┃ ┣ 📜 auth.py          # Authentication logic\n ┃ ┗ 📜 database.py      # Database connection\n ┣ 📂 frontend\n ┃ ┣ 📜 app.py           # Streamlit UI\n ┃ ┗ 📜 components.py    # UI Components\n ┣ 📜 README.md          # Project documentation\n ┣ 📜 requirements.txt   # Dependencies\n ┗ 📜 .env               # Environment variables\n```\n\n## ⚙️ Installation \u0026 Setup\n\n### 1️⃣ Clone the Repository\n```bash\ngit clone https://github.com/Kingflow-23/Expense-Tracker.git\n```\n\n### Create a Virtual Environment\n```bash\npython -m venv .\n\nsource ./bin/activate  # On Linux/Mac\n.\\Scripts\\activate  # On Windows \n``` \n\n### 2️⃣ Install Dependencies\n```bash\npython -m pip install --upgrade pip\npip install -r requirements.txt\n```\n\n### 3️⃣ Setup Environment Variables\nCreate a `.env` file and add the required configuration:\n```env\nDATABASE_URL=postgresql://user:password@localhost/db_name\nSECRET_KEY=your_secret_key\nACCESS_TOKEN_EXPIRE_MINUTES=30\n```\n\n### 4️⃣ Run the Backend\n```bash\nuvicorn backend.main:app --reload\n```\n\n### 5️⃣ Run the Frontend\n```bash\nstreamlit run frontend/app.py\n```\n\n## 🎬 Quick Demo\nBelow is a quick preview of the application in action:\n\n### 🔹 Login Page\n\n![image](https://github.com/user-attachments/assets/e8afb074-50f5-4dc5-975d-0583e44dc1dd)\n\n### 🔹 Profile Update\n\n![image](https://github.com/user-attachments/assets/c777d6f4-2f05-4ea3-b4af-81f0b65b51d6)\n\n### 🔹 Logout\n🚪➡️ Click the logout button to securely exit.\n\n## 🔗 API Endpoints\n| Method | Endpoint       | Description            |\n|--------|--------------|------------------------|\n| POST   | /auth/signup | Register a new user    |\n| POST   | /auth/login  | Authenticate user      |\n| PUT    | /auth/update | Update user profile    |\n| DELETE    | /auth/delete | Delete user         |\n| POST    | /expenses   | Register new expense   |\n| GET     | /expenses   | Retrieve all expenses  |\n| GET     | /expenses/{id} | Retrieve a specific expense  |\n| PATCH    | /expenses/{id} | Update an existing expense  |\n| DELETE    | /expenses/{id} | Delete an expense  |\n\n## 📜 License\nThis project is licensed under the MIT License.\n\n## 🙌 Contributing\nPull requests are welcome! For major changes, please open an issue first to discuss what you’d like to change.\n\n---\n*Made with ❤️ by [KingFlow-23](https://github.com/Kingflow-23)*\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingflow-23%2Fexpense-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkingflow-23%2Fexpense-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingflow-23%2Fexpense-tracker/lists"}