---

STASH is a high-performance, voice-native AI supply chain platform designed to modernize warehouse operations. By bridging the gap between physical inventory and digital intelligence, Stash empowers godown operators with multilingual voice control, predictive analytics, and automated logistics.

---

---

Bridging the Gap: From Chaos to Clarity

The Challenge	The Stash Solution
Manual Error Loops Traditional stock tracking is slow and error-prone.	Voice-Native Accuracy Update inventory hands-free with real-time AI verification.
Reactive Procurement Reordering happens too late, leading to lost sales.	Predictive Intelligence AI forecasts demand and automates reordering before you run out.
Communication Overhead Constant back-and-forth with suppliers wastes hours.	Autonomous Coordination AI handles supplier outreach and coordination via voice & text.
Cash Flow Friction Delayed billing and poor tracking hurt the bottom line.	Financial Automation Automated GST billing, credit tracking, and instant reminders.

---

Features

Feature	Description
Voice-First Operations	Multilingual Control: Manage inventory, orders, and tasks using simple voice commands in English, Hindi, etc. Hands-Free Workflow: Designed for warehouse floor efficiency where typing is a hurdle.
Smart Inventory AI	Real-Time Tracking: Instant stock updates with discrepancy alerts. Stock Intelligence: AI-driven demand prediction and reordering logic to prevent stockouts.
Automated Supply Chain	Supplier Automation: Auto-place orders with primary and backup suppliers based on stock levels. AI Negotiation: Handle price negotiations within margin rules with user oversight.
Order & Logistics	Voice-Based Ordering: Enable buyers to place and track orders via voice. Delivery Tracking: Real-time monitoring with automated follow-ups and status updates.
Financial Intelligence	Billing & Payments: Generate GST-compliant invoices and automate payment reminders. Credit Tracking: Keep tabs on supplier and buyer credit effortlessly.
Warehouse Synergy	Multi-Warehouse Management: Manage multiple godowns under one account with consolidated visibility and inter-warehouse transfers. Unified Intelligence: A central AI layer that learns and improves warehouse operations continuously.

---

---

---

Sustainable Development Goals (SDGs)

This product is committed to and supports the following Sustainable Development Goals:

• SDG 8: Decent Work and Economic Growth
• SDG 9: Industry, Innovation, and Infrastructure
• SDG 12: Responsible Consumption and Production
• SDG 13: Climate Action

---

Setup Instructions

1. Clone the repository

git clone https://github.com/shwet46/Stash.git
cd Stash
cp .env.example .env

2. Set up the AI Backend

Navigate to the backend directory and install dependencies using uv.

cd backend
uv sync
uv run uvicorn app.main:app --reload

Note: Make sure you have Python 3.12+ and uv installed.

Telegram replies require TELEGRAM_BOT_TOKEN and a public TELEGRAM_WEBHOOK_URL or BACKEND_URL that Telegram can reach. For local development, http://localhost:8000 is not enough because Telegram cannot call back into your machine. Telegram registration alerts require TELEGRAM_BOT_TOKEN to be set in your environment. The chat ID must belong to a chat that has already started the bot.

3. Set up the Frontend

Navigate to the frontend directory and install the Node dependencies.

cd ../frontend
npm install
npm run dev

Note: Make sure you have Node.js 20+ installed.

4. Docker Deployment (Optional)

Run the entire stack (including Redis and Firestore emulators) with a single command:

docker-compose up --build

---

License

This project is licensed under the Apache-2.0 license. See the LICENSE file for details.

---