Skip to content

Latest commit

 

History

History
92 lines (57 loc) · 2.69 KB

README.md

File metadata and controls

92 lines (57 loc) · 2.69 KB

TradeSage

TradeSage is a platform designed to help small Canadian businesses navigate supply chain challenges caused by tariffs. By offering a comprehensive search tool for local alternatives to tariffed goods, TradeSage helps businesses save costs and supports the Canadian economy.

DoraHacks submission: https://dorahacks.io/buidl/23017


Screenshot 2025-02-23 191021

Demonstration

Recording.2025-02-23.191308.mp4

Getting Started

To run the TradeSage web application locally, follow the steps below.

Prerequisites

Before running the project, ensure you have the following installed on your machine:

  • Node.js: Download Node.js
  • npm: npm comes with Node.js, but you can check if it's installed by running npm -v in your terminal.

Clone the Repository

First, clone the TradeSage repository to your local machine:

git clone http://github.com/vanshs64/TradeSage/

Install Dependencies

After cloning the repository, navigate to the project folder and open two terminal windows: one for the backend and one for the frontend.

1. Backend Installation

In one terminal window, go to the backend directory and run the following command to install the required dependencies:

cd TradeSage/backend
npm install

2. Frontend Installation

In the second terminal window, go to the frontend directory and install the necessary dependencies:

cd TradeSage/frontend
npm install

Running the Application

1. Start the Backend

In the backend terminal, run the following command to start the backend server:

node index.js

2. Start the Frontend

In the frontend terminal, run the following command to start the React development server:

npm run start

This will launch the frontend at http://localhost:3000.

Access the Frontend

Open your browser and go to http://localhost:3000 to access the TradeSage frontend.

Features

  • Product Search: Search for imported products or materials affected by tariffs and find local alternatives.
  • Gemini Agent Assistance: The AI assistant helps users navigate supply chain queries and provides cost comparisons.
  • Pricing and Supplier Information: Detailed product info including pricing, supplier location, and trade history.

Technologies Used

  • Frontend: React.js
  • Backend: Express.js
  • AI Integration: Gemini-powered assistance
  • Database: Google Cloud Platform (GCP)

Contributing

We welcome contributions! If you'd like to contribute to TradeSage, please fork the repository and submit a pull request.