Compare commits

..

No commits in common. "e1d4f84dae6bf91e49d96285ed977c9f5a5f0836" and "039fe9dcba8a34682f843f22352639351ff9ca53" have entirely different histories.

View file

@ -1,73 +1,34 @@
# Sparkle ✨ - The Engine Behind Twinkle # sparkle
**Sparkle** is the powerful API that fuels Twinkle, allowing you to keep track of real-time stock prices and company data with ease. This API offers detailed, accurate, and timely financial data, enabling developers to build feature-rich financial applications. #### running sparkle via docker (recommended)
> **Documentation**: [sparkle-demo.ryawaa.com/docs](https://sparkle-demo.ryawaa.com/docs) 📚
>
> **Live Demo**: [sparkle-demo.ryawaa.com](https://sparkle-demo.ryawaa.com) 🌐
>
> **GitHub Repository**: [github.com/ryanamay/sparkle](https://github.com/ryanamay/sparkle) 🐙
>
> **Source Code**: Available on [**code.lgbt**](https://code.lgbt/ryanamay/sparkle) 🏳️‍🌈
---
## Features
- **Real-Time Data**: Get access to real-time stock prices and market data.
- **Comprehensive Endpoints**: Fetch data including company financials, stock recommendations, and news.
- **Broadcast Updates**: Receive real-time updates broadcasted from a single FinHub key.
- **Scalable**: Designed to handle high volumes of requests efficiently.
- **Secure**: Implemented with robust security measures to protect your data.
- **Detailed Documentation**: [API documentation](https://sparkle-demo.ryawaa.com/docs) to help you get started quickly.
- **Source Code Available**: Open source on [**code.lgbt**](https://code.lgbt/ryanamay/sparkle) 🏳️‍⚧️!
---
## 🛠 Running Sparkle Locally
This project is not production-ready, but you can easily run it locally.
### Running Sparkle via Docker (Recommended)
```bash ```bash
docker run -d -p 8000:8000 ryanamay/sparkle docker run -d -p 8000:8000 ryanamay/sparkle
``` ```
### Running Sparkle Directly #### running sparkle directly
sparkle uses poetry to manage dependencies.
Sparkle uses Poetry to manage dependencies. to install `poetry`, run the following command:
##### via pipx (recommended)
#### 1. Install `poetry`:
##### Via pipx (Recommended)
```bash ```bash
pipx install poetry pipx install poetry
``` ```
##### Via pip
##### via pip
```bash ```bash
python3 -m venv $VENV_PATH python3 -m venv $VENV_PATH
$VENV_PATH/bin/pip install -U pip setuptools $VENV_PATH/bin/pip install -U pip setuptools
$VENV_PATH/bin/pip install poetry $VENV_PATH/bin/pip install poetry
``` ```
### 2. Running the app via uvicorn: ##### running the app via uvicorn
```bash ```bash
git clone https://github.com/ryanamay/sparkle.git git clone https://github.com/ryanamay/sparkle.git
cd sparkle
poetry install poetry install
cd app cd app
poetry run uvicorn main:app --host 0.0.0.0 --port 8000 poetry run uvicorn main:app --host 0.0.0.0 --port 8000
``` ```
---
## 🛠 Deployment
Though it's not yet production-ready, you can deploy Sparkle using any cloud provider that supports Docker or by running it directly on a server. Keep in mind that the current codebase might need refinement for production environments, and the refactor branch is in progress.
---
## 📝 License
Sparkle is licensed under an open-source license. Feel free to use it, contribute, and make it better.
##### Note: The repository is also hosted on code.lgbt a community-driven git platform for diverse developers! 🌈