Metadata-Version: 2.1
Name: nexus_databoard
Version: 0.0.1
Summary: An oppinionated data science project template for the Nexus platform. An abstraction over Streamlit.
Project-URL: Homepage, https://github.com/savantly-net/nexus-databoard
Project-URL: Bug Tracker, https://github.com/savantly-net/nexus-databoard/issues
Author-email: Jeremy Branham <jeremy@savantly.net>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# nexus-databoard

This application provides the boilerplate to rapidly build data applications on the streamlit framework (which is already rapid!).  


## Quick Start
There are a few options to get started rapidly.  

### Clone
Clone the repository, and do `pip install -r requirements.txt`  

You can add your own files to the [./pages](./pages) directory to add/replace the example pages.    
Then do `./run` or `streamlit run ./src/nexus_databoard/Home.py`  

### Docker Compose
Run the docker compose file to spin up the examples.  
You can also mount your own files in the `pages` directory in the app.  
For easy development, copy the requirements into your workspace and get autocompletion for the dependencies.  
`pip install -r requirements.txt`  

Example Compose file that mounts a local `pages` directory  
```
services:
  nexus_analytics:
    image: savantly/nexus-databoard:latest
    container_name: my-data-tools
    ports:
      - 8501:8501
    environment: []
    volumes:
      - ./pages:/app/pages
```

### Extend the image
Extend the image and add your page files to the `pages` directory.  

Example - 
```
FROM savantly/nexus-databoard
COPY ./pages /app/pages/
```
