> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spn.wtf/llms.txt
> Use this file to discover all available pages before exploring further.

# GST - Setup & Installation

> Install dependencies and run the Sahyogi GST Processor

## Required Libraries

The application depends on the following Python libraries (defined in `requirements.txt`):

| Library      | Version  | Purpose                                        |
| ------------ | -------- | ---------------------------------------------- |
| `streamlit`  | >=1.28.0 | Web framework for the UI                       |
| `pandas`     | >=2.0.0  | Data manipulation, filtering, and lookup logic |
| `openpyxl`   | >=3.1.0  | Reading `.xlsx` / `.xls` Excel files           |
| `xlsxwriter` | >=3.1.0  | Writing and formatting the final Excel outputs |

> Built-in Python libraries (`base64`, `io`, `sys`, `os`, `re`, `datetime`) are also used but require no installation.

***

## Installation

**1. Clone the repository**

```bash theme={null}
git clone https://github.com/prativahq/Sahyogi-RJV-Advisors.git
cd Sahyogi-RJV-Advisors
```

**2. Create a virtual environment** *(recommended)*

```bash theme={null}
python -m venv venv

# Windows
venv\Scripts\activate

# Mac / Linux
source venv/bin/activate
```

**3. Install dependencies**

```bash theme={null}
pip install -r requirements.txt
```

***

## Running the App

### Local Development

```bash theme={null}
streamlit run app.py
```

The app will start at `http://localhost:8501` and open automatically in your browser.

### Production Server

The app runs as a system daemon named `sahyogi` on the Linux production server.

<CodeGroup>
  ```bash Check Status theme={null}
  sudo systemctl status sahyogi
  ```

  ```bash Restart App theme={null}
  sudo systemctl restart sahyogi
  ```

  ```bash View Error Logs theme={null}
  tail -f ~/sahyogi-rjv/logs/error.log
  ```
</CodeGroup>

<Info>
  For server routing and Cloudflare tunnel details, refer to `server_commands.md`.
</Info>