oddsgym


Nameoddsgym JSON
Version 0.10.1 PyPI version JSON
download
home_pageNone
SummaryA sports betting environment for OpenAI Gym
upload_time2024-06-19 06:12:46
maintainerNone
docs_urlNone
authorOry Jonay
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Sports odds betting environment 
[![PyPI version](https://badge.fury.io/py/oddsgym.svg)](https://badge.fury.io/py/oddsgym)
![build](https://github.com/OryJonay/Odds-Gym/workflows/build/badge.svg) 
[![Coverage Status](https://coveralls.io/repos/github/OryJonay/Odds-Gym/badge.svg?branch=master)](https://coveralls.io/github/OryJonay/Odds-Gym?branch=master)
[![Hatch project](https://img.shields.io/badge/tool-%F0%9F%A5%9A%20Hatch-4051b5.svg)](https://github.com/pypa/hatch) 
[![Endpoint Badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fastral-sh%2Fruff%2Fmain%2Fassets%2Fbadge%2Fv2.json&label=linting)](https://github.com/astral-sh/ruff) 
[![License - MIT](https://img.shields.io/badge/license-MIT-9400d3.svg)](https://spdx.org/licenses/) 
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/) 

A sports betting environment for [Farma Foundation Gymnasium](https://gymnasium.farama.org/) based environments.

## Installation

    pip install oddsgym

## Environment

The starting bank is X (X > 0), representing X available bets.
Actions are all available bets for a game (depends on sport), placing 1 bet for each option. Also, the agent can not bet over his current bank (i.e can't place 3 bets when the current bank is 2).
For example, in 3-way betting for soccer, the avilable actions are:

    1. Bet on home team
    2. Bet on away team
    3. Bet on draw
    4. Bet on home team and away team
    5. Bet on home team and draw
    6. Bet on away team and draw
    7. Bet on home team and away team and draw
    8. Don't place a bet for this game

A step is placing a bet on a single game. In each step, the agent knows the betting odds for this game.
The reward for each step is the amount of money won (negative reward when losing money).
An episode is betting for a whole year or when "striking out" (losing all the money).

## Documentation

The full documentation is hosted at: https://oryjonay.github.io/Odds-Gym

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "oddsgym",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Ory Jonay",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/3b/b9/fb4d4b5d8657949a6f9ce51792b07224e6f7c5af264b40eb4406e5a24437/oddsgym-0.10.1.tar.gz",
    "platform": null,
    "description": "# Sports odds betting environment \n[![PyPI version](https://badge.fury.io/py/oddsgym.svg)](https://badge.fury.io/py/oddsgym)\n![build](https://github.com/OryJonay/Odds-Gym/workflows/build/badge.svg) \n[![Coverage Status](https://coveralls.io/repos/github/OryJonay/Odds-Gym/badge.svg?branch=master)](https://coveralls.io/github/OryJonay/Odds-Gym?branch=master)\n[![Hatch project](https://img.shields.io/badge/tool-%F0%9F%A5%9A%20Hatch-4051b5.svg)](https://github.com/pypa/hatch) \n[![Endpoint Badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fastral-sh%2Fruff%2Fmain%2Fassets%2Fbadge%2Fv2.json&label=linting)](https://github.com/astral-sh/ruff) \n[![License - MIT](https://img.shields.io/badge/license-MIT-9400d3.svg)](https://spdx.org/licenses/) \n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/) \n\nA sports betting environment for [Farma Foundation Gymnasium](https://gymnasium.farama.org/) based environments.\n\n## Installation\n\n    pip install oddsgym\n\n## Environment\n\nThe starting bank is X (X > 0), representing X available bets.\nActions are all available bets for a game (depends on sport), placing 1 bet for each option. Also, the agent can not bet over his current bank (i.e can't place 3 bets when the current bank is 2).\nFor example, in 3-way betting for soccer, the avilable actions are:\n\n    1. Bet on home team\n    2. Bet on away team\n    3. Bet on draw\n    4. Bet on home team and away team\n    5. Bet on home team and draw\n    6. Bet on away team and draw\n    7. Bet on home team and away team and draw\n    8. Don't place a bet for this game\n\nA step is placing a bet on a single game. In each step, the agent knows the betting odds for this game.\nThe reward for each step is the amount of money won (negative reward when losing money).\nAn episode is betting for a whole year or when \"striking out\" (losing all the money).\n\n## Documentation\n\nThe full documentation is hosted at: https://oryjonay.github.io/Odds-Gym\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A sports betting environment for OpenAI Gym",
    "version": "0.10.1",
    "project_urls": {
        "Homepage": "https://github.com/OryJonay/Odds-Gym"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3bb9fb4d4b5d8657949a6f9ce51792b07224e6f7c5af264b40eb4406e5a24437",
                "md5": "57e9ce72cb5c3b507d1a3fe589f16409",
                "sha256": "42657351e50f19bd26790f9824dab9384da04666f02da3f46465308c4e738cb0"
            },
            "downloads": -1,
            "filename": "oddsgym-0.10.1.tar.gz",
            "has_sig": false,
            "md5_digest": "57e9ce72cb5c3b507d1a3fe589f16409",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 18235,
            "upload_time": "2024-06-19T06:12:46",
            "upload_time_iso_8601": "2024-06-19T06:12:46.278178Z",
            "url": "https://files.pythonhosted.org/packages/3b/b9/fb4d4b5d8657949a6f9ce51792b07224e6f7c5af264b40eb4406e5a24437/oddsgym-0.10.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-19 06:12:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "OryJonay",
    "github_project": "Odds-Gym",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "oddsgym"
}
        
Elapsed time: 0.35906s