Skip to content

YannickLimmer/tippnation

Repository files navigation

TippNation

Welcome to TippNation! This is a fun little project designed to enhance the excitement of family-internal betting games. With TippNation, you can create, manage, and enjoy betting games with your family and friends in a simple and interactive way.

Features

  • Create Betting Games: Easily set up betting games for various events.
  • Manage Participants: Add and manage participants in your betting games.
  • Track Bets: Keep track of all bets placed by participants.
  • Leaderboard: Automatically calculate and display the leaderboard based on the outcomes of the bets.

How to Use

  1. Create a Game: Deploy the app including a Schedule, Admin, and Players file.
  2. Add Participants: Invite your family and friends to join the game by adding their names. Give them passwords and add them to the secrets.toml.
  3. Place Bets: Each participant can place their bets for the event, by specifying the day when the event happens.
  4. Track Results: Once the event is over, enter the results to see who won.
  5. Leaderboard: Check the leaderboard to see who has the most points and is leading the game.

Purpose

TippNation is designed to make family-internal betting games more fun and engaging. It provides an easy-to-use platform where everyone can participate, place their bets, and enjoy a friendly competition. Whether it's for sports events, reality TV shows, or any other bet-worthy events, TippNation brings an extra layer of excitement to your family gatherings.

Technologies Used

  • Streamlit: For building the web application.
  • Python: For the backend logic and data handling.
  • Pandas: For data manipulation and analysis.
  • NumPy: For numerical operations.
  • Matplotlib/Plotly: For creating visualizations.

Future Improvements

  • User Authentication: Allow users to create accounts and log in to manage their own games.
  • Notifications: Send notifications to participants about upcoming events and bet results.
  • Enhanced Leaderboard: Add more detailed statistics and analytics to the leaderboard.

Contributing

This project is currently a small, family-focused endeavor, but if you're interested in contributing, feel free to fork the repository and submit pull requests. Any suggestions for improvements are welcome!

License

This project is open-source and available under the MIT License. Feel free to use, modify, and distribute it as per the terms of the license.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages