Re-add installer README after name change (#1586)
* Re-add installer README after name change * New image and move legacy images * Update Twitter handle * Change Gamestonk to OpenBB * Add download links
65
README.md
vendored
@@ -16,24 +16,24 @@
|
||||
[![Bugs Open][bugs-open-shield]][bugs-open-url]
|
||||
[![Bugs Closed][bugs-closed-shield]][bugs-closed-url]
|
||||
|
||||
[](https://github.com/GamestonkTerminal/GamestonkTerminal/actions)
|
||||
[](https://github.com/OpenBB-finance/OpenBBTerminal/actions)
|
||||
[](https://gamestonk-terminal.readthedocs.io/?badge=latest)
|
||||
[](https://github.com/GamestonkTerminal/GamestonkTerminal/releases)
|
||||
[](https://github.com/OpenBB-finance/OpenBBTerminal/releases)
|
||||
[](https://github.com/psf/black)
|
||||
[](https://www.tickgit.com/browse?repo=github.com/GamestonkTerminal/GamestonkTerminal&branch=main)
|
||||
[](https://www.tickgit.com/browse?repo=github.com/OpenBB-finance/OpenBBTerminal&branch=main)
|
||||
|
||||

|
||||
[](https://twitter.com/gamestonkt)
|
||||
[](https://twitter.com/openbb_finance)
|
||||
|
||||
<!-- PROJECT LOGO -->
|
||||
<br />
|
||||
<p align="center">
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal">
|
||||
<img src="images/gst_logo_lockup_rGreen_with_letters.png" alt="Logo" width="800" height="276">
|
||||
<a href="https://openbb.co/">
|
||||
<img src="images/openbb_gradient.png" alt="Logo" width="1000">
|
||||
</a>
|
||||
|
||||
<h3 align="center">OpenBB Terminal 🚀</h3>
|
||||
<p align="center">Click on the gif below for a DEMO of the terminal.</p>
|
||||
<p align="center">Click on the GIF below for a DEMO of the terminal.</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://www.youtube.com/watch?v=fqGPK8OVHLk" rel="honest work">
|
||||
@@ -44,19 +44,19 @@
|
||||
<p align="center">
|
||||
Investment research for everyone.
|
||||
<br />
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal/tree/master/openbb_terminal/README.md"><strong>≪ GETTING STARTED</strong></a>
|
||||
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/tree/master/openbb_terminal/README.md"><strong>≪ GETTING STARTED</strong></a>
|
||||
  ·  
|
||||
<a href="https://gamestonkterminal.github.io/GamestonkTerminal/">
|
||||
<a href="https://openbb-finance.github.io/OpenBBTerminal/">
|
||||
<strong>SEE FEATURES »</strong></a>
|
||||
<br />
|
||||
<br />
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal/issues/new?assignees=&labels=bug&template=bug_report.md&title=%5BBug%5D">
|
||||
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/issues/new?assignees=&labels=bug&template=bug_report.md&title=%5BBug%5D">
|
||||
Report Bug</a>
|
||||
·
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal/issues/new?assignees=&labels=enhancement&template=enhancement.md&title=%5BIMPROVE%5D">
|
||||
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/issues/new?assignees=&labels=enhancement&template=enhancement.md&title=%5BIMPROVE%5D">
|
||||
Suggest Improvement</a>
|
||||
·
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal/issues/new?assignees=&labels=new+feature&template=feature_request.md&title=%5BFR%5D">
|
||||
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/issues/new?assignees=&labels=new+feature&template=feature_request.md&title=%5BFR%5D">
|
||||
Request a Feature</a>
|
||||
</p>
|
||||
</p>
|
||||
@@ -66,6 +66,7 @@
|
||||
<summary><h2 style="display: inline-block">Table of Contents</h2></summary>
|
||||
<ol>
|
||||
<li> <a href="#about-the-project">About The Project</a> </li>
|
||||
<li><a href="#installation">Installation</a></li>
|
||||
<li><a href="#contributing">Contributing</a></li>
|
||||
<li><a href="#license">License</a></li>
|
||||
<li><a href="#disclaimer">Disclaimer</a></li>
|
||||
@@ -124,11 +125,11 @@ go up.
|
||||
|
||||
Recommended if you adopted a strategy of buying high and selling low.
|
||||
|
||||
We are interested in your view on what sort of [features](https://github.com/GamestonkTerminal/GamestonkTerminal/issues)
|
||||
We are interested in your view on what sort of [features](https://github.com/OpenBB-finance/OpenBBTerminal/issues)
|
||||
would make you buy even higher and selling even lower.
|
||||
|
||||
Also, if somehow you're sitting in several mils due to this terminal, don't forget to report a
|
||||
[bug](https://github.com/GamestonkTerminal/GamestonkTerminal/issues) so that the team can fix, and keep the old ways.
|
||||
[bug](https://github.com/OpenBB-finance/OpenBBTerminal/issues) so that the team can fix, and keep the old ways.
|
||||
|
||||
**Join the 🙌 💎 Gang**
|
||||
|
||||
@@ -139,7 +140,7 @@ Welcome to the club, and feel free to support the developers behind this amazing
|
||||
## License
|
||||
|
||||
Distributed under the MIT License. See
|
||||
[LICENSE](https://github.com/GamestonkTerminal/GamestonkTerminal/blob/main/LICENSE) for more information.
|
||||
[LICENSE](https://github.com/OpenBB-finance/OpenBBTerminal/blob/main/LICENSE) for more information.
|
||||
|
||||
## Disclaimer
|
||||
|
||||
@@ -164,12 +165,12 @@ any loss or damage as a result of your trading, or your reliance on the informat
|
||||
Feel free to share loss porn, memes or any questions at:
|
||||
|
||||
- Discord: <https://discord.gg/Up2QGbMKHY>
|
||||
- Twitter: [@gamestonkt](https://twitter.com/gamestonkt)
|
||||
- Twitter: [@openbb_finance](https://twitter.com/openbb_finance)
|
||||
|
||||
### Contributors
|
||||
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal/graphs/contributors">
|
||||
<img src="https://contributors-img.web.app/image?repo=GamestonkTerminal/GamestonkTerminal" height="276"/>
|
||||
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/graphs/contributors">
|
||||
<img src="https://contributors-img.web.app/image?repo=OpenBB-finance/OpenBBTerminal" height="276"/>
|
||||
</a>
|
||||
|
||||
## Acknowledgments
|
||||
@@ -188,19 +189,19 @@ Feel free to share loss porn, memes or any questions at:
|
||||
<!-- MARKDOWN LINKS & IMAGES -->
|
||||
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
|
||||
|
||||
[contributors-shield]: https://img.shields.io/github/contributors/GamestonkTerminal/GamestonkTerminal.svg?style=for-the-badge
|
||||
[contributors-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/graphs/contributors
|
||||
[forks-shield]: https://img.shields.io/github/forks/GamestonkTerminal/GamestonkTerminal.svg?style=for-the-badge
|
||||
[forks-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/network/members
|
||||
[stars-shield]: https://img.shields.io/github/stars/GamestonkTerminal/GamestonkTerminal.svg?style=for-the-badge
|
||||
[stars-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/stargazers
|
||||
[issues-shield]: https://img.shields.io/github/issues/GamestonkTerminal/GamestonkTerminal.svg?style=for-the-badge&color=blue
|
||||
[issues-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/issues
|
||||
[bugs-open-shield]: https://img.shields.io/github/issues/GamestonkTerminal/GamestonkTerminal/bug.svg?style=for-the-badge&color=yellow
|
||||
[bugs-open-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/issues?q=is%3Aissue+label%3Abug+is%3Aopen
|
||||
[bugs-closed-shield]: https://img.shields.io/github/issues-closed/GamestonkTerminal/GamestonkTerminal/bug.svg?style=for-the-badge&color=success
|
||||
[bugs-closed-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/issues?q=is%3Aissue+label%3Abug+is%3Aclosed
|
||||
[license-shield]: https://img.shields.io/github/license/GamestonkTerminal/GamestonkTerminal.svg?style=for-the-badge
|
||||
[license-url]: https://github.com/GamestonkTerminal/GamestonkTerminal/blob/main/LICENSE.txt
|
||||
[contributors-shield]: https://img.shields.io/github/contributors/OpenBB-finance/OpenBBTerminal.svg?style=for-the-badge
|
||||
[contributors-url]: https://github.com/OpenBB-finance/OpenBBTerminal/graphs/contributors
|
||||
[forks-shield]: https://img.shields.io/github/forks/OpenBB-finance/OpenBBTerminal.svg?style=for-the-badge
|
||||
[forks-url]: https://github.com/OpenBB-finance/OpenBBTerminal/network/members
|
||||
[stars-shield]: https://img.shields.io/github/stars/OpenBB-finance/OpenBBTerminal.svg?style=for-the-badge
|
||||
[stars-url]: https://github.com/OpenBB-finance/OpenBBTerminal/stargazers
|
||||
[issues-shield]: https://img.shields.io/github/issues/OpenBB-finance/OpenBBTerminal.svg?style=for-the-badge&color=blue
|
||||
[issues-url]: https://github.com/OpenBB-finance/OpenBBTerminal/issues
|
||||
[bugs-open-shield]: https://img.shields.io/github/issues/OpenBB-finance/OpenBBTerminal/bug.svg?style=for-the-badge&color=yellow
|
||||
[bugs-open-url]: https://github.com/OpenBB-finance/OpenBBTerminal/issues?q=is%3Aissue+label%3Abug+is%3Aopen
|
||||
[bugs-closed-shield]: https://img.shields.io/github/issues-closed/OpenBB-finance/OpenBBTerminal/bug.svg?style=for-the-badge&color=success
|
||||
[bugs-closed-url]: https://github.com/OpenBB-finance/OpenBBTerminal/issues?q=is%3Aissue+label%3Abug+is%3Aclosed
|
||||
[license-shield]: https://img.shields.io/github/license/OpenBB-finance/OpenBBTerminal.svg?style=for-the-badge
|
||||
[license-url]: https://github.com/OpenBB-finance/OpenBBTerminal/blob/main/LICENSE.txt
|
||||
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
|
||||
[linkedin-url]: https://linkedin.com/in/DidierRLopes
|
||||
|
||||
|
Before Width: | Height: | Size: 153 KiB After Width: | Height: | Size: 153 KiB |
|
Before Width: | Height: | Size: 35 KiB After Width: | Height: | Size: 35 KiB |
BIN
images/installation/macos/mac_os_installation.png
vendored
Normal file
|
After Width: | Height: | Size: 705 KiB |
BIN
images/installation/macos/malicious_software_warning.png
vendored
Normal file
|
After Width: | Height: | Size: 286 KiB |
BIN
images/installation/macos/option_one_warning_fix.png
vendored
Normal file
|
After Width: | Height: | Size: 128 KiB |
BIN
images/installation/macos/option_two_warning_fix.png
vendored
Normal file
|
After Width: | Height: | Size: 75 KiB |
BIN
images/installation/windows/run_anyway.png
vendored
Normal file
|
After Width: | Height: | Size: 128 KiB |
BIN
images/installation/windows/run_the_terminal.png
vendored
Normal file
|
After Width: | Height: | Size: 163 KiB |
BIN
images/installation/windows/windows_protected_your_pc.png
vendored
Normal file
|
After Width: | Height: | Size: 125 KiB |
|
Before Width: | Height: | Size: 747 KiB After Width: | Height: | Size: 747 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 72 KiB |
|
Before Width: | Height: | Size: 89 KiB After Width: | Height: | Size: 89 KiB |
|
Before Width: | Height: | Size: 142 KiB After Width: | Height: | Size: 142 KiB |
|
Before Width: | Height: | Size: 176 KiB After Width: | Height: | Size: 176 KiB |
|
Before Width: | Height: | Size: 85 KiB After Width: | Height: | Size: 85 KiB |
|
Before Width: | Height: | Size: 60 KiB After Width: | Height: | Size: 60 KiB |
|
Before Width: | Height: | Size: 143 KiB After Width: | Height: | Size: 143 KiB |
0
images/logo.png → images/legacy/logo.png
vendored
|
Before Width: | Height: | Size: 74 KiB After Width: | Height: | Size: 74 KiB |
|
Before Width: | Height: | Size: 117 KiB After Width: | Height: | Size: 117 KiB |
BIN
images/openbb_gradient.png
vendored
Normal file
|
After Width: | Height: | Size: 585 KiB |
60
openbb_terminal/README.md
vendored
@@ -32,40 +32,40 @@ If you want to install the terminal using Python ignore the User section and jum
|
||||
If you are interested in running the terminal via the installer, these steps will guide you through the installation
|
||||
process and explain to you what each message means.
|
||||
|
||||
### Installing Process
|
||||
### Windows
|
||||
|
||||
The process starts off by downloading the installer, see below the most recent release:
|
||||
The process starts off by downloading the installer, see below for the most recent release:
|
||||
|
||||
- Windows: [LINK TO INSTALLER FILE](https://github.com/GamestonkTerminal/GamestonkTerminal/)
|
||||
- macOS: [LINK TO INSTALLER FILE](https://github.com/GamestonkTerminal/GamestonkTerminal/)
|
||||
- [Link to Windows installer](https://github.com/OpenBB-finance/OpenBBTerminal/releases/tag/v1.0.0)
|
||||
|
||||
This downloads the installer to your computer and by clicking on the created file, you are able to start
|
||||
the installation process.
|
||||
Then follow these steps:
|
||||
|
||||
**_STILL NEED TO ADD WALKTHROUGH AND IMAGES_**
|
||||
| Installation instructions | Illustration |
|
||||
|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| <div style="width:300px">Double click the .exe file that got downloaded to your "Downloads" folder. You will most likely receive the error on the right stating "Windows protected your PC". This is because the installer is still in beta phase, and the team has not yet requested verification from Windows. </div> | <p align="center"><img src="../images/installation/windows/windows_protected_your_pc.png" alt="Windows protected your PC" width="500"/></p> |
|
||||
| <div style="width:300px">Click on "More info" and select "Run anyway" to start the installation process. Proceed by following the steps. Do note that if you wish to install the application to 'Program Files' that you will have to run the resulting application as Administrator. | <p align="center"><img src="../images/installation/windows/run_anyway.png" alt="Run anyway" width="500"/></p> |
|
||||
| <div style="width:300px">By clicking on the application that appeared on your Desktop, you are able to run the Terminal. The first time this takes a bit longer to load. | <p align="center"><img src="../images/installation/windows/run_the_terminal.png" alt="Run the terminal" width="500"/></p> |
|
||||
|
||||
| Note about "Malicious Software" warning |
|
||||
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| You will most likely see one of the following images displayed below. This is because the installer is still in beta phase, and the team has not requested verification from neither Windows nor Apple. |
|
||||
### macOS
|
||||
|
||||
**_STILL NEED TO ADD IMAGES_**
|
||||
The process starts off by downloading the installer, see below for the most recent release:
|
||||
|
||||
To mark the application as safe for usage, use the following steps:
|
||||
- [Link to macOS installer](https://github.com/OpenBB-finance/OpenBBTerminal/releases/tag/v1.0.0)
|
||||
|
||||
#### On Windows
|
||||
Installation instructions:
|
||||
|
||||
**_STILL NEED TO ADD CONTENT_**
|
||||
1. Open the .dmg file that got downloaded to your "Downloads" folder.
|
||||
2. Drag the folder into your "Applications" folder. This should take some time as it is extracting the
|
||||
files from the .dmg file.
|
||||
3. Open the folder and click on the "OpenBB Terminal" file, this should run the application.
|
||||
|
||||
#### On macOS
|
||||
<img src="../images/installation/macos/mac_os_installation.png" alt="mac os installation" width=800/>
|
||||
|
||||
1. Run the file. You will most likely receive a message that macOS was not able to check whether the application
|
||||
contains malicious software. The reasoning for this is described in the note above.
|
||||
2. Go to macOS System Preferences > Security & Privacy > General. You should see see a message at the bottom that says
|
||||
that the file "_was blocked from use because it is not from an identified developer_".
|
||||
3. Click on the button "Allow anyway"
|
||||
4. You should now be able to use the application.
|
||||
|
||||
_WHAT ELSE?_
|
||||
| Note about "Cannot check it for malicious software" warning | Illustration |
|
||||
|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------|
|
||||
| <div style="width:300px">It is possible you will see the image displayed on the right. This is because the installer is still in beta phase, and the team has not yet requested verification from Apple. Please see below how to correct for this.</div> | <p align="center"><img src="../images/installation/macos/malicious_software_warning.png" alt="software warning" width="500"/></p> |
|
||||
| <div style="width:300px">**Option 1 (via MacOS settings):** <br><br> 1) Run the file. You will most likely receive a message that macOS was not able to check whether the application contains malicious software. The reasoning for this is described above. <br> 2) Go to System Preferences > Security & Privacy > General. You should see a message at the bottom that says that the file "was blocked from use because it is not from an identified developer". Click on “Allow anyway” or "Open anyway".<br> 3) If you receive the above message multiple times on different files, keep allowing the files via Step 2 or use Option 2.<br> 4) You should now be able to launch the application. | <p align="center"><img src="../images/installation/macos/option_one_warning_fix.png" alt="option 1 warning fix" width="500"/></p> |
|
||||
| <div style="width:300px">**Option 2 (via Terminal):** <br><br> 1) Run the file. You will most likely receive a message that macOS was not able to check whether the application contains malicious software. The reasoning for this is described in the note above. <br> 2) Open the "Terminal" application. This can be done by using Command (⌘) + Space and typing "terminal". <br> 3) Within this "Terminal" application, assuming you moved the file to the Applications folder, enter the following command: `xattr -r -d com.apple.quarantine "/Applications/Gamestonk Terminal"`<br> 4) You should now be able to launch the application. | <p align="center"><img src="../images/installation/macos/option_two_warning_fix.png" alt="option 2 warning fix" width="500"/></p> |
|
||||
|
||||
## Developer
|
||||
|
||||
@@ -104,7 +104,7 @@ These steps are common in all operating systems (Windows with or without WSL, Ma
|
||||
This project supports Python 3.7, 3.8 and 3.9.
|
||||
|
||||
Our current recommendation is to use this project with Anaconda's Python distribution - either full
|
||||
[**Anaconda3 Latest**](https://repo.anaconda.com/archive/) or [**Miniconda3 Latest**](https://repo.anaconda.com/archive/).
|
||||
[**Anaconda3 Latest**](https://www.anaconda.com/products/distribution) or [**Miniconda3 Latest**](https://docs.conda.io/en/latest/miniconda.html).
|
||||
Several features in this project utilize Machine Learning. Machine Learning Python dependencies are optional.
|
||||
If you decided to add Machine Learning features at a later point, you will likely have better user experience with
|
||||
Anaconda's Python distribution.
|
||||
@@ -127,13 +127,13 @@ Anaconda's Python distribution.
|
||||
|
||||
3. Clone the Project
|
||||
|
||||
- Via HTTPS: `git clone https://github.com/GamestonkTerminal/GamestonkTerminal.git`
|
||||
- via SSH: `git clone git@github.com:GamestonkTerminal/GamestonkTerminal.git`
|
||||
- Via HTTPS: `git clone https://github.com/OpenBB-finance/OpenBBTerminal.git`
|
||||
- via SSH: `git clone git@github.com:OpenBB-finance/OpenBBTerminal.git`
|
||||
|
||||
4. Navigate into the project's folder
|
||||
|
||||
```bash
|
||||
cd GamestonkTerminal/
|
||||
cd OpenBBTerminal/
|
||||
```
|
||||
|
||||
5. Create Environment
|
||||
@@ -166,7 +166,7 @@ Anaconda's Python distribution.
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
8. You're ready to Gamestonk it!
|
||||
8. You're ready to use the terminal!
|
||||
|
||||
```bash
|
||||
python terminal.py
|
||||
@@ -188,7 +188,7 @@ Anaconda's Python distribution.
|
||||
before you call `python terminal.py` again.
|
||||
|
||||
**TROUBLESHOOT:** If you are having troubles to install, check our _newest_
|
||||
<a href="https://github.com/GamestonkTerminal/GamestonkTerminal/blob/master/TROUBLESHOOT.md"><strong>troubleshoot page</strong></a>. You can also reach for help on our [discord](https://discord.gg/Up2QGbMKHY).
|
||||
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/blob/master/TROUBLESHOOT.md"><strong>troubleshoot page</strong></a>. You can also reach for help on our [discord](https://discord.gg/Up2QGbMKHY).
|
||||
|
||||
### Advanced User Install - Machine Learning
|
||||
|
||||
@@ -297,7 +297,7 @@ git stash pop
|
||||
|
||||
For API keys, create the `setenv` file if it doesn't already exist.
|
||||
It will automatically get created on the first launch, and won't get committed to Git because it is on the `.gitignore`.
|
||||
Set the API keys [as explained here](https://github.com/GamestonkTerminal/GamestonkTerminal/blob/main/DOCKER_ADVANCED.md#environment-variables).
|
||||
Set the API keys [as explained here](https://github.com/OpenBB-finance/OpenBBTerminal/blob/main/DOCKER_ADVANCED.md#environment-variables).
|
||||
Once you've put the API keys in that file, re-run the launch script, and it will use your API keys.
|
||||
There are a few things that still don't work, and you can see what works and what doesn't [here](https://github.com/CoconutMacaroon/GamestonkTerminal/blob/main/openbb_terminal_web/README.md#todo).
|
||||
|
||||
|
||||