README.md

---
title: List Analyzer App
emoji: 📊
colorFrom: blue
colorTo: green
sdk: docker
app_file: app.py
pinned: false
---
# 📊 List Analyzer App

A simple and interactive **Streamlit web application** that analyzes a list of numbers entered by the user. The app calculates the **largest**, **smallest**, and **sum** of the numbers and displays the results instantly.

---

## 🚀 Live Demo

This app is deployed on **Hugging Face Spaces**.

👉 Open the app using the public URL provided by your Space.

---

## ✨ Features

* Enter numbers separated by commas
* Instantly analyzes the list
* Displays:

  * 🔺 Largest number
  * 🔻 Smallest number
  * ➕ Sum of numbers
* Clean and simple UI
* Built with **Streamlit**

---

## 🛠️ Tech Stack

* **Python**
* **Streamlit**
* **Docker (via Hugging Face Spaces)**

---

## 📁 Project Structure

```
list-analyzer-app
│── app.py
│── requirements.txt
│── README.md
```

---

## ▶️ Run Locally

Follow these steps to run the app on your local machine:

```bash
# Install Streamlit
pip install streamlit

# Run the app
streamlit run app.py
```

The app will open in your browser at:

```
http://localhost:8501
```

---

## 📦 requirements.txt

Make sure your `requirements.txt` contains:

```
streamlit
```

---

## 🌍 Deployment

This app is deployed using:

* **Hugging Face Spaces**
* **Docker → Streamlit template**

Simply push your code to GitHub or edit directly in the Space, and Hugging Face handles the build and hosting.

---

## 🤝 Contributing

Contributions are welcome!

* Fork the repository
* Create a new branch
* Submit a pull request

---

## 📄 License

This project is open-source and available under the **MIT License**.

---

## 🙌 Acknowledgements

* Streamlit
* Hugging Face Spaces

---

Happy coding! 🚀