{"id":31176119,"url":"https://github.com/rivalcoder/inventra-agent","last_synced_at":"2025-09-19T13:11:37.696Z","repository":{"id":297932605,"uuid":"997176530","full_name":"Rivalcoder/Inventra-Agent","owner":"Rivalcoder","description":"Inventra is an AI-powered inventory management webapp designed to make stock control smarter, faster, and easier.","archived":false,"fork":false,"pushed_at":"2025-09-02T15:47:50.000Z","size":1056,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-02T17:38:07.808Z","etag":null,"topics":["gemini-ai","multithreading","nextjs"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Rivalcoder.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-06T04:53:16.000Z","updated_at":"2025-09-02T15:48:49.000Z","dependencies_parsed_at":"2025-08-07T06:17:26.965Z","dependency_job_id":"267bb512-2266-4766-89c3-df657049bc75","html_url":"https://github.com/Rivalcoder/Inventra-Agent","commit_stats":null,"previous_names":["rivalcoder/ai_inventory","rivalcoder/inventra-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Rivalcoder/Inventra-Agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rivalcoder%2FInventra-Agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rivalcoder%2FInventra-Agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rivalcoder%2FInventra-Agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rivalcoder%2FInventra-Agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rivalcoder","download_url":"https://codeload.github.com/Rivalcoder/Inventra-Agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rivalcoder%2FInventra-Agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275942911,"owners_count":25556989,"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","status":"online","status_checked_at":"2025-09-19T02:00:09.700Z","response_time":108,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["gemini-ai","multithreading","nextjs"],"created_at":"2025-09-19T13:04:09.870Z","updated_at":"2025-09-19T13:11:37.685Z","avatar_url":"https://github.com/Rivalcoder.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003c!-- Banner --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://readme-typing-svg.demolab.com?font=Fira+Code\u0026weight=700\u0026size=28\u0026pause=1000\u0026color=1A56DB\u0026center=true\u0026vCenter=true\u0026width=600\u0026lines=InventSmart+AI+%F0%9F%A7%A0+%7C+AI-Powered+Inventory+%26+Sales+Manager\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Next.js-15.3.3-black?logo=nextdotjs\u0026style=for-the-badge\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/React-18.2.0-61DAFB?logo=react\u0026style=for-the-badge\u0026logoColor=black\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Tailwind_CSS-3.3.3-38BDF8?logo=tailwindcss\u0026style=for-the-badge\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/AI_Gemini-Google-4285F4?logo=google\u0026style=for-the-badge\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MySQL-8.0-4479A1?logo=mysql\u0026style=for-the-badge\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-green?style=for-the-badge\"/\u003e\n\u003c/p\u003e\n\n---\n\n# 🚀 Inventra-Agent\n\n\u003e \u003cspan style=\"font-size:1.2em;\"\u003e✨ \u003cb\u003eAI-Powered Inventory \u0026 Sales Management System\u003c/b\u003e ✨\u003c/span\u003e\n\nInventra-Agent is a modern, full-stack inventory and sales management platform supercharged with AI analytics and natural language querying. Track products, manage sales, generate beautiful reports, and get instant insights with the power of Google Gemini AI.\n\n---\n\n## 🌟 Features\n\n- 📊 **Dashboard** — Real-time revenue, inventory value, sales, and low stock alerts\n- 📦 **Inventory Management** — Add, edit, delete, and view products with live stock tracking\n- 🛒 **Sales Management** — Record, view, and manage sales transactions\n- 🤖 **AI Query Console** — Ask natural language questions and get instant, AI-generated insights and SQL\n- 📈 **Reports** — Generate and download detailed sales/inventory reports (PDF/CSV)\n- 🛠️ **Settings** — Customize company info, currency, notifications, backup, and more\n- 🔔 **Notifications** — Low stock and important event alerts\n- 🌗 **Theme Support** — Light, dark, and system themes\n- 💾 **Data Backup \u0026 Restore** — Export/import your database for safety and migration\n\n---\n\n## 🛠️ Tech Stack\n\n| Frontend | Backend | AI | Data | UI/UX |\n|:--------:|:-------:|:--:|:----:|:-----:|\n| ![React](https://img.shields.io/badge/React-18.2.0-61DAFB?logo=react) \u003cbr\u003e ![Next.js](https://img.shields.io/badge/Next.js-15.3.3-black?logo=nextdotjs) \u003cbr\u003e ![Tailwind](https://img.shields.io/badge/Tailwind_CSS-3.3.3-38BDF8?logo=tailwindcss) | ![Next.js API](https://img.shields.io/badge/API-Next.js-informational?logo=nextdotjs) \u003cbr\u003e ![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?logo=mysql) | ![Gemini](https://img.shields.io/badge/AI-Gemini-4285F4?logo=google) \u003cbr\u003e ![Zod](https://img.shields.io/badge/Validation-Zod-8E44AD?logo=zod) | ![Recharts](https://img.shields.io/badge/Charts-Recharts-FF6384?logo=recharts) \u003cbr\u003e ![html2pdf.js](https://img.shields.io/badge/PDF-html2pdf.js-FFB300?logo=adobeacrobatreader) | ![Radix UI](https://img.shields.io/badge/Radix_UI-1.2.0-FF61A6?logo=radixui) \u003cbr\u003e ![Lucide](https://img.shields.io/badge/Icons-Lucide-1E293B?logo=lucide) |\n\n---\n\n## 🗄️ Database Schema\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClick to expand\u003c/b\u003e\u003c/summary\u003e\n\n### \u003ckbd\u003eproducts\u003c/kbd\u003e\n| Field       | Type         | Description                       |\n|-------------|--------------|-----------------------------------|\n| id          | VARCHAR(36)  | Primary Key                       |\n| name        | VARCHAR(255) | Product name (unique)             |\n| description | TEXT         | Product description               |\n| category    | VARCHAR(100) | Product category                  |\n| price       | DECIMAL(10,2)| Unit price                        |\n| stock       | INT          | Current stock                     |\n| minStock    | INT          | Minimum stock for alerts          |\n| supplier    | VARCHAR(255) | Supplier name                     |\n| createdAt   | DATETIME     | Creation timestamp                |\n| updatedAt   | DATETIME     | Last update timestamp             |\n\n### \u003ckbd\u003esales\u003c/kbd\u003e\n| Field       | Type         | Description                       |\n|-------------|--------------|-----------------------------------|\n| id          | VARCHAR(36)  | Primary Key                       |\n| productId   | VARCHAR(36)  | Foreign Key to products           |\n| productName | VARCHAR(255) | Product name                      |\n| quantity    | INT          | Quantity sold                     |\n| price       | DECIMAL(10,2)| Unit price at sale                |\n| total       | DECIMAL(10,2)| Total sale amount                 |\n| date        | DATETIME     | Sale date                         |\n| customer    | VARCHAR(255) | Customer name (default: Anonymous)|\n\n### \u003ckbd\u003esettings\u003c/kbd\u003e\n| Field         | Type         | Description                       |\n|---------------|--------------|-----------------------------------|\n| id            | VARCHAR(36)  | Primary Key                       |\n| setting_key   | VARCHAR(255) | Unique key                        |\n| value         | TEXT         | Value                             |\n| type          | VARCHAR(50)  | Data type                         |\n| description   | TEXT         | Description                       |\n| isEncrypted   | BOOLEAN      | Is value encrypted?               |\n| createdAt     | DATETIME     | Creation timestamp                |\n| updatedAt     | DATETIME     | Last update timestamp             |\n\n\u003c/details\u003e\n\n---\n\n## 🚦 Quick Start\n\n```sh\n# 1. Clone the repo\n$ git clone \u003crepo-url\u003e\n$ cd Ai_Inventory\n\n# 2. Install dependencies\n$ npm install\n\n# 3. Configure environment variables\n$ cp .env.example .env\n# Edit .env with your MySQL \u0026 Google API credentials\n\n# 4. Run the app\n$ npm run dev\n# Visit http://localhost:3000\n```\n\n---\n\n## 🧠 AI Query Console\n\n\u003e 🤖 \u003cb\u003eAsk questions like:\u003c/b\u003e\n\u003e - What are our top 5 selling products?\n\u003e - Which products are running low on stock?\n\u003e - Show me the total sales for this month.\n\n- The AI will analyze your data, generate insights, and even provide SQL queries for data modifications.\n- Responses are formatted with tables, lists, and markdown for clarity.\n\n---\n\n\n\n## 📂 Project Structure\n\n```text\napp/\n  api/           # API routes (AI, DB)\n  inventory/     # Inventory management UI\n  sales/         # Sales management UI\n  query/         # AI query console\n  reports/       # Reporting UI\n  settings/      # Settings UI\ncomponents/      # Reusable UI components\nlib/             # Data fetching, context, types, utils\nhooks/           # Custom React hooks\npublic/          # Static assets\n```\n\n---\n\n## 🤝 Contributing\n\n1. Fork the repo\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## Made By Rivalcoder\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frivalcoder%2Finventra-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frivalcoder%2Finventra-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frivalcoder%2Finventra-agent/lists"}