{"id":22123844,"url":"https://github.com/erhardtconsulting/tensortrade-ng","last_synced_at":"2025-10-12T01:37:32.416Z","repository":{"id":254710044,"uuid":"843587404","full_name":"erhardtconsulting/tensortrade-ng","owner":"erhardtconsulting","description":"TensorTrade-NG is an open source Python framework for building, training, evaluating, and deploying robust trading algorithms using reinforcement learning.","archived":false,"fork":false,"pushed_at":"2024-08-28T20:11:28.000Z","size":65799,"stargazers_count":177,"open_issues_count":2,"forks_count":30,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-30T12:45:18.570Z","etag":null,"topics":["artificial-intelligence","finance","machine-learning","reinforcement-learning","reinforcement-learning-environments","trading","tradingbot"],"latest_commit_sha":null,"homepage":"https://tensortrade-ng.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erhardtconsulting.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-16T21:12:18.000Z","updated_at":"2025-08-20T21:07:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"172cbfad-b066-4ea2-89e5-a92ddff7bbc2","html_url":"https://github.com/erhardtconsulting/tensortrade-ng","commit_stats":null,"previous_names":["erhardtconsulting/tensortrade-ng"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/erhardtconsulting/tensortrade-ng","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erhardtconsulting%2Ftensortrade-ng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erhardtconsulting%2Ftensortrade-ng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erhardtconsulting%2Ftensortrade-ng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erhardtconsulting%2Ftensortrade-ng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erhardtconsulting","download_url":"https://codeload.github.com/erhardtconsulting/tensortrade-ng/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erhardtconsulting%2Ftensortrade-ng/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279009742,"owners_count":26084648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["artificial-intelligence","finance","machine-learning","reinforcement-learning","reinforcement-learning-environments","trading","tradingbot"],"created_at":"2024-12-01T15:39:16.373Z","updated_at":"2025-10-12T01:37:32.410Z","avatar_url":"https://github.com/erhardtconsulting.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"﻿[![Apache License](https://img.shields.io/github/license/erhardtconsulting/tensortrade-ng.svg?color=brightgreen)](http://www.apache.org/licenses/LICENSE-2.0)\r\n[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)\r\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=erhardtconsulting_tensortrade-ng\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=erhardtconsulting_tensortrade-ng)\r\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=erhardtconsulting_tensortrade-ng\u0026metric=coverage)](https://sonarcloud.io/summary/new_code?id=erhardtconsulting_tensortrade-ng)\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"https://raw.githubusercontent.com/erhardtconsulting/tensortrade-ng/main/docs/source/_static/logo.svg\"\u003e\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n\u003e **ℹ️ TensorTrade-NG was forked from the [TensorTrade](https://github.com/tensortrade-org/tensortrade)-Project, mainly because the code needed a lot refactoring, was outdated and it looked not really maintained anymore. Therefor we did a lot of breaking changes, removed old unused stuff and cleaned up. We tried to preserve the APIs but if you want to switch from TensorTrade to TensorTrade-NG be aware that it may take a little bit of effort. Apart from that we thank all the former developers and community for their awesome work and are happy to welcome them here.**\r\n\r\n**TensorTrade-NG is still in Beta, meaning it should be used very cautiously if used in production, as it may contain bugs.**\r\n\r\nTensorTrade-NG is an open source Python framework for building, training, evaluating, and deploying robust trading algorithms using reinforcement learning. The framework focuses on being highly composable and extensible, to allow the system to scale from simple trading strategies on a single CPU, to complex investment strategies run on a distribution of HPC machines.\r\n\r\nUnder the hood, the framework uses many of the APIs from existing machine learning libraries to maintain high quality data pipelines and learning models. One of the main goals of TensorTrade is to enable fast experimentation with algorithmic trading strategies, by leveraging the existing tools and pipelines provided by `numpy`, `pandas` and `gymnasium`. The idea behind Tensorflow-NG is not to implement all the machine learning stuff itself. But to provide a solid framework that makes it possible to quickly provide a working environment for other tools such as [Stable-Baselines3](https://stable-baselines3.readthedocs.io).\r\n\r\nEvery piece of the framework is split up into re-usable components, allowing you to take advantage of the general use components built by the community, while keeping your proprietary features private. The aim is to simplify the process of testing and deploying robust trading agents using deep reinforcement learning, to allow you and I to focus on creating profitable strategies.\r\n\r\n_The goal of this framework is to enable fast experimentation, while maintaining production-quality data pipelines._\r\n\r\nRead [the documentation](https://tensortrade-ng.io/).\r\n\r\n## Guiding principles\r\n\r\n_Inspired by [Keras' guiding principles](https://github.com/keras-team/keras)._\r\n\r\n- **User friendliness.** TensorTrade is an API designed for human beings, not machines. It puts user experience front and center. TensorTrade follows best practices for reducing cognitive load: it offers consistent \u0026 simple APIs, it minimizes the number of user actions required for common use cases, and it provides clear and actionable feedback upon user error.\r\n\r\n- **Modularity.** A trading environment is a conglomeration of fully configurable modules that can be plugged together with as few restrictions as possible. In particular, exchanges, feature pipelines, action schemes, reward schemes, trading agents, and performance reports are all standalone modules that you can combine to create new trading environments.\r\n\r\n- **Easy extensibility.** New modules are simple to add (as new classes and functions), and existing modules provide ample examples. To be able to easily create new modules allows for total expressiveness, making TensorTrade suitable for advanced research and production use.\r\n\r\n## Getting Started\r\n\r\nYou can get started testing on Google Colab or your local machine, by viewing our [many examples](https://github.com/erhardtconsulting/tensortrade-ng/tree/master/examples).\r\n\r\n**Recommended beginning points:**\r\n\r\n* [Sample Environment as Python Script](https://github.com/erhardtconsulting/tensortrade-ng/blob/main/examples/simple_training_environment.py)\r\n* \r\n\r\n## Installation\r\n\r\nTensorTrade-NG recommends Python \u003e= 3.12.0 for all functionality to work as expected.\r\n\r\n### As package\r\nYou can install TensorTrade-NG both as a pre-packaged solution by running the default setup command.\r\n```bash\r\npip install tensortrade-ng\r\n```\r\n\r\n### Via git\r\nYou can also alternatively install TensorTrade-NG directly from the master code repository, pulling directly from the latest commits. This will give you the latest features/fixes, but it is highly untested code, so proceed at your own risk.\r\n```bash\r\npip install git+https://github.com/erhardtconsulting/tensortrade-ng.git\r\n```\r\n\r\n### Cloning the repository\r\n\r\n\u003e **⚠️ Warning**: This repository uses *git-lfs* for storing the Jupyter Notebooks and other big files. Make sure to install the [git-lfs Extension](https://git-lfs.com/) before cloning the repository.\r\n\r\nYou can clone/download the repository in your local environment and manually install the requirements, either the \"base\" ones, or the ones that also include requirements to run the examples in the documentation.\r\n\r\n```bash\r\n# install only base requirements\r\npip install -e .\r\n\r\n# install all requirements\r\npip install -e \".[dev]\"\r\n```\r\n\r\n### Build Documentation\r\n\r\nYou can either build the documentation once or serve it locally.\r\n\r\n\u003e **Prerequisites:** You need to have [pandoc](https://pandoc.org/installing.html) installed locally for converting jupyter notebooks. Otherwise it won't work. The *pip*-version won't work, because it's just a wrapper. You need to use your package manager, like `brew` or `apt`. \r\n\r\n**Run documentation as local webserver**\r\n\r\n```bash\r\nhatch run docs:serve\r\n```\r\n\r\n**Build documentation**\r\n\r\n```bash\r\nhatch run docs:build\r\n```\r\n\r\n### Run Test Suite\r\n\r\nTo run the test suite, execute the following command.\r\n\r\n```bash\r\n# Test all\r\nhatch run test:run\r\n\r\n# Test only specific python version\r\nhatch run +py=3.12 test:run\r\n\r\n# Test with coverage (only one python version recommended)\r\nhatch run +py=3.12 test:run-cov\r\n```\r\n\r\n## Support\r\n\r\nYou can also post **bug reports and feature requests** in [GitHub issues](https://github.com/erhardtconsulting/tensortrade-ng/issues). Make sure to read [our guidelines](https://github.com/erhardtconsulting/tensortrade-ng/blob/master/CONTRIBUTING.md) first.\r\n\r\nIf you have **questions or anything else** that needs to be discussed. Please use [GitHub Discussions](https://github.com/erhardtconsulting/tensortrade-ng/discussions) rather than opening an issue.\r\n\r\n\r\n## Contributors\r\n\r\nContributions are encouraged and welcomed. This project is meant to grow as the community around it grows. Let us know on [GitHub Discussions](https://github.com/erhardtconsulting/tensortrade-ng/discussions) if there is anything that you would like to see in the future, or if there is anything you feel is missing.\r\n\r\n**Working on your first Pull Request?** You can learn how from this _free_ series [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).\r\n\r\n![https://github.com/erhardtconsulting/tensortrade-ng/graphs/contributors](https://contributors-img.firebaseapp.com/image?repo=erhardtconsulting/tensortrade-ng)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferhardtconsulting%2Ftensortrade-ng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferhardtconsulting%2Ftensortrade-ng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferhardtconsulting%2Ftensortrade-ng/lists"}