Skip to content

Commit

Permalink
Merge pull request #17 from hummingbot/edit-readme
Browse files Browse the repository at this point in the history
README edits
  • Loading branch information
cardosofede authored May 9, 2023
2 parents 4f7ddf9 + a755291 commit 17f0a3a
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 25 deletions.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -133,3 +133,6 @@ dmypy.json

# Pyre type checker
.pyre/

# Database
/data
60 changes: 35 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,51 @@
# Hummingbot StreamLit Apps
# Hummingbot Dashboards

Collection of Hummingbot-related data apps and dashboards, built using [StreamLit](https://streamlit.io/).
Collection of Hummingbot-related dashboards, built using [StreamLit](https://streamlit.io/).

This repository is maintained by Hummingbot Foundation as a companion for users of [Hummingbot](https://github.com/hummingbot/hummingbot), the open source framework for building high-frequency crypto trading bots.

### Getting Started Video

Watch this video to understand how it works:
https://www.loom.com/share/72d05bcbaf4048a399e3f9247d756a63

### Deployed Apps
See an example of a live, deployed dashboard:
https://hummingbot-streamlit-app-main-jnja50.streamlit.app

https://hummingbot-streamlit-apps-main-jnja50.streamlit.app
## Dashboards

## Current Data Apps
Here are the current dashboards in the collection:

Here are the current data apps in the collection:
### 🚀 Strategy Performance (WIP)

### XE Token Analyzer
Dashboard that helps you analyze the performance of a running Hummingbot instance

Visualize the bid-ask spread and volume of different tokens across the crypto exchange landscape. This app is most helpful for Hummingbot users running the [Cross-Exchange Market Making](https://hummingbot.org/strategies/cross-exchange-market-making/) and [Arbitrage](https://hummingbot.org/strategies/arbitrage/) strategies.
### 🧙 XE Token Analyzer

### Hummingbot DB
Dashboard that helps you visualize the bid-ask spread and volume of different tokens across the crypto exchange landscape.

Drop a SQLite trades file for a specific strategy configuration, so that you can inspect and analyze the trade data.
This app is most helpful for Hummingbot users running the [Cross-Exchange Market Making](https://hummingbot.org/strategies/cross-exchange-market-making/) and [Arbitrage](https://hummingbot.org/strategies/arbitrage/) strategies.

### TVL vs MCAP Analysis
### 🧳 Hummingbot DB

Easily compare various DeFi protocols based on their market capitalization and total value locked, using DeFiLlama data.
Inspect and analyze the orders and trades data contained in a SQLite database for a strategy or script.

These files are located in the `/data` folder in Hummingbot, and are named `<strategy_name>.sqlite`.

**How to find**: These files are located in the `/data` folder in Hummingbot, and are named `<strategy_name>.sqlite`.
### 🦉 TVL vs MCAP Analysis

Easily compare various DeFi protocols based on their market capitalization and total value locked, using DeFiLlama data.

### Data
### 📋 Data

Reference data for the various apps this collection.

## Installation

1. Install Anaconda or Miniconda
1. Install [Anaconda](https://www.anaconda.com/) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html)

2. Clone this repo and navigate to the created directory
```
git clone https://github.com/hummingbot/streamlit-apps.git
cd streamlit-apps
```bash
git clone https://github.com/hummingbot/dashboard.git
cd dashboard
```

3. Run this command to create a `conda` environment and install dependencies
Expand All @@ -50,19 +54,25 @@ conda env create -f environment_conda.yml
```

4. Activate the environment
```
conda activate streamlit-apps
```bash
conda activate dashboard
```

5. Run the app
```
```bash
streamlit run main.py
```

For more info, see instructions located at https://docs.streamlit.io/library/get-started/installation.
6. Create a symlink to your Hummingbot `/data` directory
```bash
# replace `/path/to/hummingbot` with the actual path
ln -s /path/to/hummingbot/data data
```

For more info about Streamlit installation, see the instructions located at https://docs.streamlit.io/library/get-started/installation.

## Contributions

We welcome new data apps, bug fixes, and improvements by the community!

To submit a contribution, issue a pull request and follow the general guidelines listed at https://hummingbot.org/developers/contributions.
To submit a contribution, issue a pull request, following the guidelines listed at https://hummingbot.org/developers/contributions.
File renamed without changes.
File renamed without changes.

0 comments on commit 17f0a3a

Please sign in to comment.