diff --git a/site/.gitlab-ci.yml b/site/.gitlab-ci.yml index ee4c5a5..5832d4b 100644 --- a/site/.gitlab-ci.yml +++ b/site/.gitlab-ci.yml @@ -1,23 +1,23 @@ -image: python:3.11 - -build_site: - stage: build - script: - - cd ./site - - pip install -r requirements.txt - - mkdocs build --site-dir ../public --verbose - artifacts: - paths: - - public - -deploy_site: - stage: deploy - script: - - echo "Publishing site..." - dependencies: - - build_site - artifacts: - paths: - - public - rules: - - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH' +image: python:3.11 + +build_site: + stage: build + script: + - cd ./site + - pip install -r requirements.txt + - mkdocs build --site-dir ../public --verbose + artifacts: + paths: + - public + +deploy_site: + stage: deploy + script: + - echo "Publishing site..." + dependencies: + - build_site + artifacts: + paths: + - public + rules: + - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH' diff --git a/site/.vscode/settings.json b/site/.vscode/settings.json index d0231bf..a77acdd 100644 --- a/site/.vscode/settings.json +++ b/site/.vscode/settings.json @@ -1,12 +1,12 @@ -{ - "yaml.schemas": { - "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml" - }, - "yaml.customTags": [ - "!ENV scalar", - "!ENV sequence", - "tag:yaml.org,2002:python/name:materialx.emoji.to_svg", - "tag:yaml.org,2002:python/name:materialx.emoji.twemoji", - "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format" - ] +{ + "yaml.schemas": { + "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml" + }, + "yaml.customTags": [ + "!ENV scalar", + "!ENV sequence", + "tag:yaml.org,2002:python/name:materialx.emoji.to_svg", + "tag:yaml.org,2002:python/name:materialx.emoji.twemoji", + "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format" + ] } \ No newline at end of file diff --git a/site/LICENSE b/site/LICENSE index 18a8b73..e6ff068 100644 --- a/site/LICENSE +++ b/site/LICENSE @@ -1,21 +1,21 @@ -MIT License - -Copyright (c) 2019 Anson Biggs - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +MIT License + +Copyright (c) 2019 Anson Biggs + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/site/docs/LICENSE.md b/site/docs/LICENSE.md index b32cd29..6f0d1b9 100644 --- a/site/docs/LICENSE.md +++ b/site/docs/LICENSE.md @@ -1,23 +1,23 @@ -``` -MIT License - -Copyright (c) 2019 Anson Biggs - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. -``` +``` +MIT License + +Copyright (c) 2019 Anson Biggs + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +``` diff --git a/site/docs/commands.md b/site/docs/commands.md index 6c6ee3b..bdb8061 100644 --- a/site/docs/commands.md +++ b/site/docs/commands.md @@ -1,176 +1,176 @@ -Symbols are used in headings to denote what platforms and symbol types a command supports. - -- Telegram Only :fontawesome-brands-telegram-plane: -- Discord Only :fontawesome-brands-discord: -- Bot Commands :robot: -- Cryptocurrency Support :material-currency-btc: -- Stock Market Support :bank: -- OTC Support :dollar: - -## Symbol Detection :material-currency-btc: :bank: :dollar: - -The Simple Stock Bot looks at every message it can see and tries to detect stock and cryptocurrency symbols. Stock market tickers are denoted with a single `$` and cryptocurrency coins are denoted with a double `$$`. So getting the price of Tesla is as simple as `$tsla` and Bitcoin `$$btc`. These symbols can be in any part of a message and there can be multiple of them aswell. - -
-
-
- I wonder how $tsla is affecting the price of $$btc -
-
- The current stock price of Tesla Inc is $866.57, the stock is currently up 1.68% -
-
- The current price of Bitcoin is $34,815, the coin is currently down -0.151% for today -
-
-
- -## `/donate [Amount in USD]` :fontawesome-brands-telegram-plane: - -The donate command is used to send money to the bot to help keep it free. The premium stock market data and server rentals add up so any amount helps. See the [Donate](donate.md) page for more information. - -
-
-
- /donate -
-
- The current stock price of Tesla Inc is $664.315, the stock is - currently down -0.99% -
-
-
- -## `/intra [symbol]` :bank: :material-currency-btc: - -This command makes a chart of a stocks movement since the last market open, or the last 24 hours for cryptocurrency. - -
-
-
- /intra $astr -
-
- Tesla Motors Chart -

Intraday chart for $ASTR from 06 Jul at 09:30 to 06 Jul at 15:59

-

The current stock price of Astra Space Inc - Class A is $12.47, the stock is currently down -19.39%

-
- -
- -
- -## `/chart [symbol]` :bank: :material-currency-btc: - -This command makes a chart of the last 1 month of trading data up until the day before. For example running it on May 5th creates a chart from April 5th to May 4th. - -
-
-
- /intra $astr -
-
- Tesla Motors Chart -

1 Month chart for Ethereum from 07, Jun 2021 to 07, Jul 2021

-

The current price of Ethereum is $2,389.62, the coin is currently up 2.485% for today

-
- -
- -
- -## `/trending` - -Gets the latest trending stocks and their change in price - -
-
-
- /trending -
-
-
-🦍Trending on the Stock Bot:
-━━━━━━━━━━━━━━━━━━━━━━━━━━
-$GME: Gamestop Corporation - Class A, 5.06%
-$MMAT: Meta Materials Inc, 4.77%
-$$BTC: Bitcoin, -0.83%
-$$ETH: Ethereum, 6.06%
-$$DOGE: Binance-Peg Dogecoin, 0.14%
-
-
-πŸ’΅Trending Stocks:
-━━━━━━━━━━━━━━━━
-$BBIG: Vinco Ventures Inc, 15.44%
-$GSAT: Globalstar Inc., -15.32%
-$AMC: AMC Entertainment Holdings Inc - Class A, 8.77%
-$ACIU: AC Immune SA, 16.31%
-$PLTR: Palantir Technologies Inc - Class A, 2.25%
-$AAPL: Apple Inc, -0.84%
-$XELA: Exela Technologies Inc, 12.61%
-$WFC: Wells Fargo & Co., -5.60%
-$BAC: Bank Of America Corp., 0.22%
-$AMD: Advanced Micro Devices Inc., -0.54%
-
-
-🦎Trending Crypto:
-━━━━━━━━━━━━━━━━
-$$NFD: Feisty Doge NFT, -34.32%
-$$SLP: Smooth Love Potion, -13.02%
-$$PVU: Plant vs Undead Token, -1.27%
-$$XED: Exeedme, 1.02%
-$$SOL: Solana, -3.95%
-$$BNB: Binance Coin, -0.25%
-$$EWT: Energy Web Token, 17.72%
-
-        
-
- -
- -## /help :robot: - -Just a simple command to get help in app. Returns a more summarized version of this page. - -
-
-
- /help -
-
- The current stock price of Tesla Inc is $664.315, the stock is - currently down -0.99% -
-
-
- -## `/status` :robot: - -This command is to get diagnostic information about the bot and the services it is dependant on in order to operate. Any issues should be reported to me. [Contact](contact.md) - -
-
-
- /status -
-
-Bot Status:
-        It took 0.783369 seconds for the bot to get your message.
-
-        Stock Market Data:
-        marketdata.app is currently not reporting any issues with its API.
-
-        Cryptocurrency Data:
-        CoinGecko API responded that it was OK in 0.160962 Seconds.
-        
-
- -
- -## Inline Features :fontawesome-brands-telegram: :material-currency-btc: :bank: :dollar: - -You can type @SimpleStockBot `[search]` in any chat or direct message to search for the stock bots -full list of stock symbols and return the price of the ticker. Then once you select the ticker -want the bot will send a message as you in that chat with the latest stock price. -The bot also looks at every message in any chat it is in for stock symbols.Symbols start with a -`$` followed by the stock symbol. For example:$tsla would return price information for Tesla Motors. +Symbols are used in headings to denote what platforms and symbol types a command supports. + +- Telegram Only :fontawesome-brands-telegram-plane: +- Discord Only :fontawesome-brands-discord: +- Bot Commands :robot: +- Cryptocurrency Support :material-currency-btc: +- Stock Market Support :bank: +- OTC Support :dollar: + +## Symbol Detection :material-currency-btc: :bank: :dollar: + +The Simple Stock Bot looks at every message it can see and tries to detect stock and cryptocurrency symbols. Stock market tickers are denoted with a single `$` and cryptocurrency coins are denoted with a double `$$`. So getting the price of Tesla is as simple as `$tsla` and Bitcoin `$$btc`. These symbols can be in any part of a message and there can be multiple of them aswell. + +
+
+
+ I wonder how $tsla is affecting the price of $$btc +
+
+ The current stock price of Tesla Inc is $866.57, the stock is currently up 1.68% +
+
+ The current price of Bitcoin is $34,815, the coin is currently down -0.151% for today +
+
+
+ +## `/donate [Amount in USD]` :fontawesome-brands-telegram-plane: + +The donate command is used to send money to the bot to help keep it free. The premium stock market data and server rentals add up so any amount helps. See the [Donate](donate.md) page for more information. + +
+
+
+ /donate +
+
+ The current stock price of Tesla Inc is $664.315, the stock is + currently down -0.99% +
+
+
+ +## `/intra [symbol]` :bank: :material-currency-btc: + +This command makes a chart of a stocks movement since the last market open, or the last 24 hours for cryptocurrency. + +
+
+
+ /intra $astr +
+
+ Tesla Motors Chart +

Intraday chart for $ASTR from 06 Jul at 09:30 to 06 Jul at 15:59

+

The current stock price of Astra Space Inc - Class A is $12.47, the stock is currently down -19.39%

+
+ +
+ +
+ +## `/chart [symbol]` :bank: :material-currency-btc: + +This command makes a chart of the last 1 month of trading data up until the day before. For example running it on May 5th creates a chart from April 5th to May 4th. + +
+
+
+ /intra $astr +
+
+ Tesla Motors Chart +

1 Month chart for Ethereum from 07, Jun 2021 to 07, Jul 2021

+

The current price of Ethereum is $2,389.62, the coin is currently up 2.485% for today

+
+ +
+ +
+ +## `/trending` + +Gets the latest trending stocks and their change in price + +
+
+
+ /trending +
+
+
+🦍Trending on the Stock Bot:
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+$GME: Gamestop Corporation - Class A, 5.06%
+$MMAT: Meta Materials Inc, 4.77%
+$$BTC: Bitcoin, -0.83%
+$$ETH: Ethereum, 6.06%
+$$DOGE: Binance-Peg Dogecoin, 0.14%
+
+
+πŸ’΅Trending Stocks:
+━━━━━━━━━━━━━━━━
+$BBIG: Vinco Ventures Inc, 15.44%
+$GSAT: Globalstar Inc., -15.32%
+$AMC: AMC Entertainment Holdings Inc - Class A, 8.77%
+$ACIU: AC Immune SA, 16.31%
+$PLTR: Palantir Technologies Inc - Class A, 2.25%
+$AAPL: Apple Inc, -0.84%
+$XELA: Exela Technologies Inc, 12.61%
+$WFC: Wells Fargo & Co., -5.60%
+$BAC: Bank Of America Corp., 0.22%
+$AMD: Advanced Micro Devices Inc., -0.54%
+
+
+🦎Trending Crypto:
+━━━━━━━━━━━━━━━━
+$$NFD: Feisty Doge NFT, -34.32%
+$$SLP: Smooth Love Potion, -13.02%
+$$PVU: Plant vs Undead Token, -1.27%
+$$XED: Exeedme, 1.02%
+$$SOL: Solana, -3.95%
+$$BNB: Binance Coin, -0.25%
+$$EWT: Energy Web Token, 17.72%
+
+        
+
+ +
+ +## /help :robot: + +Just a simple command to get help in app. Returns a more summarized version of this page. + +
+
+
+ /help +
+
+ The current stock price of Tesla Inc is $664.315, the stock is + currently down -0.99% +
+
+
+ +## `/status` :robot: + +This command is to get diagnostic information about the bot and the services it is dependant on in order to operate. Any issues should be reported to me. [Contact](contact.md) + +
+
+
+ /status +
+
+Bot Status:
+        It took 0.783369 seconds for the bot to get your message.
+
+        Stock Market Data:
+        marketdata.app is currently not reporting any issues with its API.
+
+        Cryptocurrency Data:
+        CoinGecko API responded that it was OK in 0.160962 Seconds.
+        
+
+ +
+ +## Inline Features :fontawesome-brands-telegram: :material-currency-btc: :bank: :dollar: + +You can type @SimpleStockBot `[search]` in any chat or direct message to search for the stock bots +full list of stock symbols and return the price of the ticker. Then once you select the ticker +want the bot will send a message as you in that chat with the latest stock price. +The bot also looks at every message in any chat it is in for stock symbols.Symbols start with a +`$` followed by the stock symbol. For example:$tsla would return price information for Tesla Motors. diff --git a/site/docs/contact.md b/site/docs/contact.md index 4e58c2d..de10a6f 100644 --- a/site/docs/contact.md +++ b/site/docs/contact.md @@ -1,8 +1,8 @@ -# I Would Love to Hear From You! - -Your feedback and experience with Simple Stock Bot is invaluable. Whether you've encountered a bug, have a suggestion for improvement, or just want to share your experience, I'm all ears. Here are several ways you can get in touch: - -- **Telegram**: Drop me a message on [Telegram](https://t.me/MisterBiggs). -- **Discord**: Feel free to reach out on Discord at `MisterBiggs#0465`. -- **Twitter**: Send me a tweet on [Twitter](https://twitter.com/AnsonBiggs). -- **GitLab**: For technical issues or feature requests, feel free to open an issue on our [GitLab Repository](https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot). +# I Would Love to Hear From You! + +Your feedback and experience with Simple Stock Bot is invaluable. Whether you've encountered a bug, have a suggestion for improvement, or just want to share your experience, I'm all ears. Here are several ways you can get in touch: + +- **Telegram**: Drop me a message on [Telegram](https://t.me/MisterBiggs). +- **Discord**: Feel free to reach out on Discord at `MisterBiggs#0465`. +- **Twitter**: Send me a tweet on [Twitter](https://twitter.com/AnsonBiggs). +- **GitLab**: For technical issues or feature requests, feel free to open an issue on our [GitLab Repository](https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot). diff --git a/site/docs/donate.md b/site/docs/donate.md index dc7f8d0..1924556 100644 --- a/site/docs/donate.md +++ b/site/docs/donate.md @@ -1,21 +1,21 @@ -# Support Simple Stock Bot - -Running Simple Stock Bot incurs a yearly expense of about $420, covering server costs and premium market data subscription from [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo). Every donation helps in maintaining the bot and ensuring its continued availability for all users. - -Your support through [Buy Me A Coffee](https://www.buymeacoffee.com/Anson) is greatly appreciated, which accepts both PayPal and Credit Card donations. - -For Telegram users, a convenient way to donate is by using the `/donate` [command](commands.md#donate-amount-in-usd). - -Should you have any inquiries, feel free to get in [touch](contact.md). - -## Additional Support: - -Your engagement also counts as support! Here are other ways to contribute: - -- Stay updated by following me on [Twitter](https://twitter.com/AnsonBiggs). -- Contribute to the project or star it on [GitLab](https://gitlab.com/simple-stock-bots). -- If you plan to host your own bot, consider using my referral links: - - [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web) - - [DigitalOcean](https://m.do.co/c/6b5df7ef55b6) - -Your support in any form is immensely appreciated and helps in keeping Simple Stock Bot operational and free for everyone. +# Support Simple Stock Bot + +Running Simple Stock Bot incurs a yearly expense of about $420, covering server costs and premium market data subscription from [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo). Every donation helps in maintaining the bot and ensuring its continued availability for all users. + +Your support through [Buy Me A Coffee](https://www.buymeacoffee.com/Anson) is greatly appreciated, which accepts both PayPal and Credit Card donations. + +For Telegram users, a convenient way to donate is by using the `/donate` [command](commands.md#donate-amount-in-usd). + +Should you have any inquiries, feel free to get in [touch](contact.md). + +## Additional Support: + +Your engagement also counts as support! Here are other ways to contribute: + +- Stay updated by following me on [Twitter](https://twitter.com/AnsonBiggs). +- Contribute to the project or star it on [GitLab](https://gitlab.com/simple-stock-bots). +- If you plan to host your own bot, consider using my referral links: + - [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web) + - [DigitalOcean](https://m.do.co/c/6b5df7ef55b6) + +Your support in any form is immensely appreciated and helps in keeping Simple Stock Bot operational and free for everyone. diff --git a/site/docs/host.md b/site/docs/host.md index 5ae5402..6288bd3 100644 --- a/site/docs/host.md +++ b/site/docs/host.md @@ -1,47 +1,47 @@ -# Self-Hosting Guide - -This guide provides step-by-step instructions for setting up and running this project on your local machine, whether for development, testing, or personal use. - -## Pre-requisites - -Ensure the following are installed or obtained before proceeding: - -- **[Docker](https://hub.docker.com/?overlay=onboarding)**: The project is containerized using Docker Compose, allowing it to run on any system with Docker installed. -- **API Keys**: - - **Telegram**: Obtain a free API key by interacting with [BotFather](https://telegram.me/botfather). More details [here](https://core.telegram.org/bots#3-how-do-i-create-a-bot). - - **Discord**: Get a free API key at [https://discord.com/developers](https://discord.com/developers). - - **[marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web)**: Sign up to get an API key. A free tier is available and should suffice for private groups. More details [here](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo). - -!!! tip -The bot will still operate without a [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo) key but will revert to using only cryptocurrency data. - -!!! note -To enable donation acceptance, obtain a Stripe API key and provide a `STRIPE` key to your bot. [https://stripe.com/]() - -## Setup Instructions - -1. **Download/Clone the Repository**: - - Download or clone this repository to your local machine. - -2. **Configure Environment Variables**: - - Navigate to the project directory and locate the `.env` file. - - Fill in the `.env` file with your obtained API keys: - - ```plaintext - MARKETDATA=your_marketdata_api_key - STRIPE=your_stripe_api_key - TELEGRAM=your_telegram_api_key - DISCORD=your_discord_api_key - ``` - - Alternatively, pass the variables using Docker Compose environment variables or command-line arguments. - -3. **Build and Run the Bot:** - - Open a terminal in the project directory. - - Build and run both bots using Docker Compose: - - ```bash - docker-compose up - ``` - -Now, your bot(s) should be up and running! If you're unfamiliar with Docker, reviewing the [Docker documentation](https://docs.docker.com/) is highly recommended to gain better control over your bot and understand Docker commands better. +# Self-Hosting Guide + +This guide provides step-by-step instructions for setting up and running this project on your local machine, whether for development, testing, or personal use. + +## Pre-requisites + +Ensure the following are installed or obtained before proceeding: + +- **[Docker](https://hub.docker.com/?overlay=onboarding)**: The project is containerized using Docker Compose, allowing it to run on any system with Docker installed. +- **API Keys**: + - **Telegram**: Obtain a free API key by interacting with [BotFather](https://telegram.me/botfather). More details [here](https://core.telegram.org/bots#3-how-do-i-create-a-bot). + - **Discord**: Get a free API key at [https://discord.com/developers](https://discord.com/developers). + - **[marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web)**: Sign up to get an API key. A free tier is available and should suffice for private groups. More details [here](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo). + +!!! tip +The bot will still operate without a [marketdata.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=repo) key but will revert to using only cryptocurrency data. + +!!! note +To enable donation acceptance, obtain a Stripe API key and provide a `STRIPE` key to your bot. [https://stripe.com/]() + +## Setup Instructions + +1. **Download/Clone the Repository**: + - Download or clone this repository to your local machine. + +2. **Configure Environment Variables**: + - Navigate to the project directory and locate the `.env` file. + - Fill in the `.env` file with your obtained API keys: + + ```plaintext + MARKETDATA=your_marketdata_api_key + STRIPE=your_stripe_api_key + TELEGRAM=your_telegram_api_key + DISCORD=your_discord_api_key + ``` + + Alternatively, pass the variables using Docker Compose environment variables or command-line arguments. + +3. **Build and Run the Bot:** + - Open a terminal in the project directory. + - Build and run both bots using Docker Compose: + + ```bash + docker-compose up + ``` + +Now, your bot(s) should be up and running! If you're unfamiliar with Docker, reviewing the [Docker documentation](https://docs.docker.com/) is highly recommended to gain better control over your bot and understand Docker commands better. diff --git a/site/docs/index.md b/site/docs/index.md index 576bd2a..c7d3f7e 100644 --- a/site/docs/index.md +++ b/site/docs/index.md @@ -1,31 +1,31 @@ -# Elevate Your Groupchats with Real-time Stock Insights - -Discover a new level of financial discussion with Simple Stock Bot, your go-to solution for real-time stock market and cryptocurrency insights within your Telegram or Discord group chats. Transform your everyday discussions into an interactive financial exploration experience. With Simple Stock Bot, keeping up with the stock market or cryptocurrency trends has never been more seamless and engaging. - -## [Commands](commands.md) - -### Real-Time Stock and Cryptocurrency Updates -- Get live price updates of stocks and cryptocurrencies. -- Symbol Detection: Use `$` for stocks and `$$` for cryptocurrencies, e.g., `$tsla` for Tesla and `$$btc` for Bitcoin. - -### Intraday and Historical Data Visualization -- `/intra`: View a stock's movement since the last market open or a cryptocurrency's 24-hour chart. -- `/chart`: Provides a chart of the last month's trading data up till the day before. - -### Trending Assets Awareness -- `/trending`: Discover the latest trending stocks and cryptocurrencies and their price changes. - -### In-App Assistance and Support -- `/help`: Provides a quick summary of available commands for easy reference. -- `/donate`: Support the maintenance of the bot to ensure continued free access. - -### User-Friendly Interaction -- Easy symbol and command usage for a smooth user experience. -- Engage with a community of financial enthusiasts and share insights effortlessly. - -## [Contact](contact.md) -Need assistance or have inquiries? Feel free to reach out and I'll be happy to help. - -## Powered by MarketData.app - -Simple Stock Bots is able to provide real-time stock market insights thanks to the data supplied by [MarketData.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web). MarketData.app delivers accurate and up-to-date financial data, fueling the bot's capabilities in delivering timely stock quotes, charts, and other market-related information directly to your Telegram or Discord groups. The robust data infrastructure provided by MarketData.app not only ensures the reliability and accuracy of the information you receive but also enables the offering of Simple Stock Bots for free to all users. By leveraging MarketData.app's comprehensive financial data, the goal is to foster informed financial discussions and make market monitoring an effortless and accessible experience for everyone. +# Elevate Your Groupchats with Real-time Stock Insights + +Discover a new level of financial discussion with Simple Stock Bot, your go-to solution for real-time stock market and cryptocurrency insights within your Telegram or Discord group chats. Transform your everyday discussions into an interactive financial exploration experience. With Simple Stock Bot, keeping up with the stock market or cryptocurrency trends has never been more seamless and engaging. + +## [Commands](commands.md) + +### Real-Time Stock and Cryptocurrency Updates +- Get live price updates of stocks and cryptocurrencies. +- Symbol Detection: Use `$` for stocks and `$$` for cryptocurrencies, e.g., `$tsla` for Tesla and `$$btc` for Bitcoin. + +### Intraday and Historical Data Visualization +- `/intra`: View a stock's movement since the last market open or a cryptocurrency's 24-hour chart. +- `/chart`: Provides a chart of the last month's trading data up till the day before. + +### Trending Assets Awareness +- `/trending`: Discover the latest trending stocks and cryptocurrencies and their price changes. + +### In-App Assistance and Support +- `/help`: Provides a quick summary of available commands for easy reference. +- `/donate`: Support the maintenance of the bot to ensure continued free access. + +### User-Friendly Interaction +- Easy symbol and command usage for a smooth user experience. +- Engage with a community of financial enthusiasts and share insights effortlessly. + +## [Contact](contact.md) +Need assistance or have inquiries? Feel free to reach out and I'll be happy to help. + +## Powered by MarketData.app + +Simple Stock Bots is able to provide real-time stock market insights thanks to the data supplied by [MarketData.app](https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web). MarketData.app delivers accurate and up-to-date financial data, fueling the bot's capabilities in delivering timely stock quotes, charts, and other market-related information directly to your Telegram or Discord groups. The robust data infrastructure provided by MarketData.app not only ensures the reliability and accuracy of the information you receive but also enables the offering of Simple Stock Bots for free to all users. By leveraging MarketData.app's comprehensive financial data, the goal is to foster informed financial discussions and make market monitoring an effortless and accessible experience for everyone. diff --git a/site/docs/stylesheets/phone.css b/site/docs/stylesheets/phone.css index 0bb40a9..848bf57 100644 --- a/site/docs/stylesheets/phone.css +++ b/site/docs/stylesheets/phone.css @@ -1,40 +1,40 @@ -/* https://codepen.io/RG/pen/bdfDI */ -.phone { - background: none repeat scroll 0 0 #fff; - /*border-left: 1px solid #ccc; - border-right: 1px solid #ccc;*/ - color: #ffffff; - font-family: sans-serif; - line-height: 20px; - width: 80%; - margin: 0 auto; - overflow-x: hidden; - position: relative; - border-radius: 10px; - margin: 50px; -} -.messages-wrapper { - position: relative; -} -.message { - margin: 10px; - padding: 15px 20px; - position: relative; - overflow-x: auto; -} -.message.to { - border-radius: 20px 0px 20px 20px; - background-color: #2095fe; - color: #fff; - margin-left: 20%; -} -.message.from { - border-radius: 20px 20px 20px 0px; - background-color: #e5e4e9; - color: #363636; - margin-right: 20%; -} -.message.to + .message.to, -.message.from + .message.from { - margin-top: -7px; -} +/* https://codepen.io/RG/pen/bdfDI */ +.phone { + background: none repeat scroll 0 0 #fff; + /*border-left: 1px solid #ccc; + border-right: 1px solid #ccc;*/ + color: #ffffff; + font-family: sans-serif; + line-height: 20px; + width: 80%; + margin: 0 auto; + overflow-x: hidden; + position: relative; + border-radius: 10px; + margin: 50px; +} +.messages-wrapper { + position: relative; +} +.message { + margin: 10px; + padding: 15px 20px; + position: relative; + overflow-x: auto; +} +.message.to { + border-radius: 20px 0px 20px 20px; + background-color: #2095fe; + color: #fff; + margin-left: 20%; +} +.message.from { + border-radius: 20px 20px 20px 0px; + background-color: #e5e4e9; + color: #363636; + margin-right: 20%; +} +.message.to + .message.to, +.message.from + .message.from { + margin-top: -7px; +} diff --git a/site/mkdocs.yml b/site/mkdocs.yml index 306bc6f..e28dbfa 100644 --- a/site/mkdocs.yml +++ b/site/mkdocs.yml @@ -1,79 +1,79 @@ -site_name: Simple Stock Bot -site_url: https://simplestockbot.com -edit_uri: /simple-stock-bots/site/tree/master/site -repo_url: https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot -repo_name: Simple Stock Bots - -site_description: Simple Discord and Telegram chat bots for Stock Market Data. -site_author: Anson Biggs -copyright: Anson Biggs 2018
Available Under an MIT LICENSE
- - -nav: - - Home: index.md - - Commands: commands.md - - Self-Host: host.md - - Donate: donate.md - - Contact: contact.md - - Blog: /blog - -theme: - name: material - language: en - features: - - navigation.instant - - navigation.tracking - - navigation.tabs - - navigation.tabs.sticky - - content.code.copy - icon: - logo: material/robot-love - palette: - - media: "(prefers-color-scheme: light)" - primary: green - scheme: default - toggle: - icon: material/lightbulb-outline - name: Switch to dark mode - - media: "(prefers-color-scheme: dark)" - primary: green - scheme: slate - toggle: - icon: material/lightbulb - name: Switch to light mode - -extra: - social: - - icon: fontawesome/solid/house - link: https://simplestockbot.com/ - - icon: fontawesome/brands/telegram - link: https://t.me/SimpleStockBot - name: Get the Telegram bot - - icon: fontawesome/brands/discord - link: https://discordapp.com/api/oauth2/authorize?client_id=532045200823025666&permissions=36507338752&scope=bot - name: Get the Discord Bot - - icon: material/chart-line-stacked - link: https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web - name: MarketData.app for stock data - - - - -extra_css: - - stylesheets/phone.css - - -plugins: - - search - - social - - blog - - -markdown_extensions: - - attr_list - - pymdownx.emoji: - emoji_index: !!python/name:materialx.emoji.twemoji - emoji_generator: !!python/name:materialx.emoji.to_svg - - admonition - - pymdownx.details - - pymdownx.superfences +site_name: Simple Stock Bot +site_url: https://simplestockbot.com +edit_uri: /simple-stock-bots/site/tree/master/site +repo_url: https://gitlab.com/simple-stock-bots/simple-telegram-stock-bot +repo_name: Simple Stock Bots + +site_description: Simple Discord and Telegram chat bots for Stock Market Data. +site_author: Anson Biggs +copyright: Anson Biggs 2018
Available Under an MIT LICENSE
+ + +nav: + - Home: index.md + - Commands: commands.md + - Self-Host: host.md + - Donate: donate.md + - Contact: contact.md + - Blog: /blog + +theme: + name: material + language: en + features: + - navigation.instant + - navigation.tracking + - navigation.tabs + - navigation.tabs.sticky + - content.code.copy + icon: + logo: material/robot-love + palette: + - media: "(prefers-color-scheme: light)" + primary: green + scheme: default + toggle: + icon: material/lightbulb-outline + name: Switch to dark mode + - media: "(prefers-color-scheme: dark)" + primary: green + scheme: slate + toggle: + icon: material/lightbulb + name: Switch to light mode + +extra: + social: + - icon: fontawesome/solid/house + link: https://simplestockbot.com/ + - icon: fontawesome/brands/telegram + link: https://t.me/SimpleStockBot + name: Get the Telegram bot + - icon: fontawesome/brands/discord + link: https://discordapp.com/api/oauth2/authorize?client_id=532045200823025666&permissions=36507338752&scope=bot + name: Get the Discord Bot + - icon: material/chart-line-stacked + link: https://dashboard.marketdata.app/marketdata/aff/go/misterbiggs?keyword=web + name: MarketData.app for stock data + + + + +extra_css: + - stylesheets/phone.css + + +plugins: + - search + - social + - blog + + +markdown_extensions: + - attr_list + - pymdownx.emoji: + emoji_index: !!python/name:materialx.emoji.twemoji + emoji_generator: !!python/name:materialx.emoji.to_svg + - admonition + - pymdownx.details + - pymdownx.superfences diff --git a/site/requirements.txt b/site/requirements.txt index b3019f8..eb19917 100644 --- a/site/requirements.txt +++ b/site/requirements.txt @@ -1,5 +1,5 @@ -mkdocs-material==9.4.4 - -# Required for Social Cards -Pillow==10.0.1 +mkdocs-material==9.4.4 + +# Required for Social Cards +Pillow==10.0.1 CairoSVG==2.7.1 \ No newline at end of file