From 461ccfc3a3ac2d40fddd4d59e5e18517dc23c1c9 Mon Sep 17 00:00:00 2001 From: DUYN Date: Fri, 19 Jun 2020 20:14:57 +0200 Subject: [PATCH 1/3] Change naming --- MANIFEST.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MANIFEST.in b/MANIFEST.in index c6615221..653e5e47 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,4 +1,4 @@ -graft investing_bot_framework +graft investing_algorithm_framework include AUTHORS include INSTALL include LICENSE From 81808b46ef5230b9e654e25675657d01c3534b8c Mon Sep 17 00:00:00 2001 From: DUYN Date: Fri, 19 Jun 2020 21:53:43 +0200 Subject: [PATCH 2/3] Update readme --- README.md | 81 +++++++++++-------------------------------------------- 1 file changed, 16 insertions(+), 65 deletions(-) diff --git a/README.md b/README.md index 88d45387..ac88b8e1 100644 --- a/README.md +++ b/README.md @@ -2,13 +2,14 @@ # Investing Algorithm Framework -The Investing Algorithm Framework is a free and open source Python framework that encourages rapid development and clean, -pragmatic design. +The Investing Algorithm Framework is a python framework to build investment algorithms. It encourages rapid development and clean, +pragmatic design. It is free for personal usage and open source. -The goal is to give you a configurable investing algorithm where you can decide how you implement your data providers, -strategies, and order executors. +In most cases, you'll probably never have to change code on this repo directly if you are building your own algorithm/bot. But if you do, check out CONTRIBUTING.md -#####Disclaimer +If you'd like to chat with investing-algorithm-framework users and developers, [join us on Slack](https://inv-algo-framework.slack.com) + +#### Disclaimer If you use this framework for your investments, do not risk money which you are afraid to lose. We can't stress this enough: @@ -18,81 +19,31 @@ YOUR OWN RISK. THE AUTHORS AND ALL AFFILIATES ASSUME NO RESPONSIBILITY FOR YOUR Also, make sure that you read the source code of any plugin you use or implementation of an algorithm made with this framework. -Documentation ------- -All documentation is in the "docs" directory and online at "". If you're just getting started, here's how we recommend -you read the docs: - -* First, read install for instructions on installing Investing Algorithm Framework. -* Next, work through the tutorials in order. ("Quickstart", "Template algorithm", "Custom algorithm"). -* For concrete algorithm examples you probably want to read through the topical guides. - - -## Development branches - -The project is currently setup in two main branches: - -- `develop` - This branch has often new features, but might also cause breaking changes. -- `master` - This branch contains the latest stable release. The bot 'should' be stable on this branch, and is generally well tested. -- `feature/*` - These are feature branches, which are being worked on heavily. Please don't use these unless you want to test a specific feature. -- `hotfix/*` - These are hot fix branches, which are being worked on heavily. Please don't use these unless you really need to. - +## Documentation +All documentation can be found online at "". ### Help / Slack For any questions not covered by the documentation or for further -information about the bot, we encourage you to join our slack channel. +information about the framework, we encourage you to join our slack channel. -[Slack](https://join.slack.com/t/investingbots/shared_invite/enQtODgwNTg3MzA2MjYyLTdiZjczZDRlNWJjNDdmYThiMGE0MzFhOTg4Y2E0NzQ2OTgxYjA1NzU3ZWJiY2JhOTE1ZGJlZGFiNDU3OTAzMDg) +[join us on Slack](https://inv-algo-framework.slack.com) ### [Bugs / Issues](https://github.com/investingbots/value-investing-bot/issues?q=is%3Aissue) If you discover a bug in the bot, please -[search our issue tracker](https://github.com/investingbots/value-investing-bot/issues?q=is%3Aissue) +[search our issue tracker](https://github.com/investing-algorithms/investing-algorithm-framework/issues?q=is%3Aissue) first. If it hasn't been reported, please -[create a new issue](https://github.com/investingbots/value-investing-bot/issues/new) and -ensure you follow the template guide so that our team can assist you as -quickly as possible. - -### [Feature Requests](https://github.com/investingbots/value-investing-bot/labels/enhancement) - -Have you a great idea to improve the bot you want to share? Please, -first search if this feature was not [already discussed](https://github.com/investingbots/value-investing-bot/labels/enhancement). -If it hasn't been requested, please -[create a new request](https://github.com/investingbots/value-investing-bot/new) -and ensure you follow the template guide so that it does not get lost -in the bug reports. - -### [Pull Requests](https://github.com/investingbots/value-investing-bot/pulls) +[create a new issue](https://github.com/investing-algorithms/investing-algorithm-framework/issues/new) and +ensure you follow the template guide so that developers can assist you as quickly as possible. -Feel like our bot is missing a feature? We welcome your pull requests! +Feel like the framework is missing a feature? We welcome your pull requests! Please read our -[Contributing document](https://github.com/investingbots/value-investing-bot/blob/develop/CONTRIBUTING.md) +[Contributing document](https://github.com/investing-algorithms/investing-algorithm-framework/blob/master/CONTRIBUTING.md) to understand the requirements before sending your pull-requests. **Note** before starting any major new feature work, *please open an issue describing what you are planning to do* or talk to us on [Slack](https://join.slack.com/t/investingbots/shared_invite/enQtODgwNTg3MzA2MjYyLTdiZjczZDRlNWJjNDdmYThiMGE0MzFhOTg4Y2E0NzQ2OTgxYjA1NzU3ZWJiY2JhOTE1ZGJlZGFiNDU3OTAzMDg). This will ensure that interested parties can give valuable feedback on the feature, and let others know that you are working on it. -**Important:** Always create your PR against the `develop` branch, not `master`. - -## Requirements - -### Uptodate clock -The clock must be accurate, syncronized to a NTP server very frequently to avoid problems with communication to the exchanges. - -### Min hardware required - -To run this bot we recommend you a cloud instance with a minimum of: - -- Minimal (advised) system requirements: 2GB RAM, 1GB disk space, 2vCPU - -In the future raspberry pi support will be added. - -### Software requirements - -- [Python 3.6.x](http://docs.python-guide.org/en/latest/starting/installation/) -- [pip](https://pip.pypa.io/en/stable/installing/) -- [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) -- [virtualenv](https://virtualenv.pypa.io/en/stable/installation/) (Recommended) -- [Docker](https://www.docker.com/products/docker) (Recommended) \ No newline at end of file +**Important:** Always create your feature or hotfix against the `develop` branch, not `master`. From f8b38748204214e64a505a6a4d4ba1ba08f73f7f Mon Sep 17 00:00:00 2001 From: DUYN Date: Fri, 19 Jun 2020 21:55:27 +0200 Subject: [PATCH 3/3] Update readme --- INSTALL | 6 ------ README.md | 12 ++++++------ 2 files changed, 6 insertions(+), 12 deletions(-) delete mode 100644 INSTALL diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 4344e649..00000000 --- a/INSTALL +++ /dev/null @@ -1,6 +0,0 @@ -Thanks for downloading the investing bot framework. - -To install it, make sure you have Python 3.6 or greater installed. Then run -this command from the command prompt: - - python -m pip install . \ No newline at end of file diff --git a/README.md b/README.md index ac88b8e1..f2aa3e76 100644 --- a/README.md +++ b/README.md @@ -5,18 +5,18 @@ The Investing Algorithm Framework is a python framework to build investment algorithms. It encourages rapid development and clean, pragmatic design. It is free for personal usage and open source. -In most cases, you'll probably never have to change code on this repo directly if you are building your own algorithm/bot. But if you do, check out CONTRIBUTING.md +In most cases, you'll probably never have to change code on this repo directly if you are building your algorithm/bot. But if you do, check out CONTRIBUTING.md If you'd like to chat with investing-algorithm-framework users and developers, [join us on Slack](https://inv-algo-framework.slack.com) #### Disclaimer -If you use this framework for your investments, do not risk money which you are afraid to lose. We can't stress this -enough: +If you use this framework for your investments, do not risk money which you are afraid to lose. We can't stress this +enough: -BEFORE YOU START USING MONEY WITH THE FRAMEWORK, MAKE SURE THAT YOU TESTED YOUR COMPONENTS THOROUGHLY. USE THE SOFTWARE AT +BEFORE YOU START USING MONEY WITH THE FRAMEWORK, MAKE SURE THAT YOU TESTED YOUR COMPONENTS THOROUGHLY. USE THE SOFTWARE AT YOUR OWN RISK. THE AUTHORS AND ALL AFFILIATES ASSUME NO RESPONSIBILITY FOR YOUR INVESTMENT RESULTS. -Also, make sure that you read the source code of any plugin you use or implementation of an algorithm made with this +Also, make sure that you read the source code of any plugin you use or implementation of an algorithm made with this framework. ## Documentation @@ -43,7 +43,7 @@ Please read our [Contributing document](https://github.com/investing-algorithms/investing-algorithm-framework/blob/master/CONTRIBUTING.md) to understand the requirements before sending your pull-requests. -**Note** before starting any major new feature work, *please open an issue describing what you are planning to do* or talk to us on [Slack](https://join.slack.com/t/investingbots/shared_invite/enQtODgwNTg3MzA2MjYyLTdiZjczZDRlNWJjNDdmYThiMGE0MzFhOTg4Y2E0NzQ2OTgxYjA1NzU3ZWJiY2JhOTE1ZGJlZGFiNDU3OTAzMDg). +**Note** before starting any major new feature work, *please open an issue describing what you are planning to do* or talk to us on [Slack](https://join.slack.com/t/investingbots/shared_invite/enQtODgwNTg3MzA2MjYyLTdiZjczZDRlNWJjNDdmYThiMGE0MzFhOTg4Y2E0NzQ2OTgxYjA1NzU3ZWJiY2JhOTE1ZGJlZGFiNDU3OTAzMDg). This will ensure that interested parties can give valuable feedback on the feature, and let others know that you are working on it. **Important:** Always create your feature or hotfix against the `develop` branch, not `master`.