README.md

metadata

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:

# 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! 🚀