mirror of
https://github.com/ryanamay/sparkle.git
synced 2024-09-20 06:00:36 +00:00
Compare commits
2 commits
039fe9dcba
...
e1d4f84dae
Author | SHA1 | Date | |
---|---|---|---|
e1d4f84dae | |||
dccd93b21e |
1 changed files with 49 additions and 10 deletions
59
README.md
59
README.md
|
@ -1,34 +1,73 @@
|
||||||
# sparkle
|
# Sparkle ✨ - The Engine Behind Twinkle
|
||||||
|
|
||||||
#### running sparkle via docker (recommended)
|
**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.
|
||||||
|
|
||||||
|
> **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.
|
|
||||||
|
|
||||||
to install `poetry`, run the following command:
|
Sparkle uses Poetry to manage dependencies.
|
||||||
##### 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
|
||||||
```
|
```
|
||||||
|
|
||||||
##### running the app via uvicorn
|
### 2. 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! 🌈
|
||||||
|
|
Loading…
Reference in a new issue