https://github.com/stav/crablox

Leading Indicators
https://github.com/stav/crablox

Last synced: 8 months ago
JSON representation

Leading Indicators

• Host: GitHub
• URL: https://github.com/stav/crablox
• Owner: stav
• License: unlicense
• Created: 2024-12-29T20:39:06.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-07-18T02:13:23.000Z (11 months ago)
• Last Synced: 2025-10-09T11:51:49.786Z (8 months ago)
• Language: Python
• Homepage:
• Size: 4.89 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# README

## Install

### Clone

    ┌─[stav][legion][~/.../Python/FastHTML]

    └─▪ git clone git@github.com:stav/crablox.git

      Cloning into 'crablox'...

      remote: Enumerating objects: 4, done.

      remote: Counting objects: 100% (4/4), done.

      remote: Compressing objects: 100% (4/4), done.

      remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)

      Receiving objects: 100% (4/4), done.

### Virtual Environment

    ┌─[stav][legion][±][master ✓][~/.../FastHTML/crablox]

    └─▪ python  -m venv venv

    ┌─[stav][legion][±][master ✓][~/.../FastHTML/crablox]

    └─▪ . venv/bin/activate

### Dependencies

    ┌─(venv)[stav][legion][±][master ✓][~/.../FastHTML/crablox]

    └─▪ pip install --upgrade pip

    ┌─(venv)[stav][legion][±][master ✓][~/.../FastHTML/crablox]

    └─▪ pip install python-fasthtml fh_altair requests pandas fa6-icons openpyxl yfinance

      Looking in indexes: https://pypi.org/simple, https://packagecloud.io/github/git-lfs/pypi/simple

      Collecting python-fasthtml

        Downloading python_fasthtml-0.12.1-py3-none-any.whl.metadata (8.8 kB)

      Collecting fh_altair

        Using cached fh_altair-0.1.0-py2.py3-none-any.whl.metadata (1.5 kB)

      Collecting requests

        Using cached requests-2.32.3-py3-none-any.whl.metadata (4.6 kB)

      Collecting pandas

        Downloading pandas-2.2.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (89 kB)

        ...

### Structure

    ┌─(venv)[stav][legion][±][master ✓][~/.../FastHTML/crablox]

    └─▪ ls -lA

      drwxr-xr-x 2 stav stav  4096 Dec 29 17:11 crablox/

      drwxr-xr-x 9 stav stav  4096 Dec 29 17:15 .git/

      -rw-r--r-- 1 stav stav  3415 Dec 29 15:39 .gitignore

      -rw-r--r-- 1 stav stav  1211 Dec 29 15:39 LICENSE

      -rw-r--r-- 1 stav stav 12790 Dec 29 17:13 README

      -rw-r--r-- 1 stav stav   820 Dec 29 17:13 requirements.txt

      drwxr-xr-x 5 stav stav  4096 Dec 29 15:44 venv/

      drwxr-xr-x 2 stav stav  4096 Dec 29 17:13 .vscode/

## Usage

Source the virtual environment:

    ┌─[stav][legion][±][master ✓][~/.../FastHTML/crablox]

    └─▪ . venv/bin/activate

## Development

Explicit environment variables:

    ┌─(venv)[stav][legion][±][trunk {1} U:3 ✗][~/.../FastHTML/crablox]

    └─▪ export PORT=5001; export CRB=devel; python crablox/main.py

      Using "devel" environment for 

      Link: http://localhost:5001

      INFO:     Will watch for changes in these directories: ['/home/stav/Work/Python/FastHTML/crablox']

      INFO:     Uvicorn running on http://0.0.0.0:5001 (Press CTRL+C to quit)

      INFO:     Started reloader process [12207] using WatchFiles

      Using "devel" environment for 

      Using "devel" environment for 

      INFO:     Started server process [12224]

      INFO:     Waiting for application startup.

      INFO:     Application startup complete.

## Scripts

These scripts automate data extraction.

### ISM Manufacturing

Run the script:

    python scripts/ism-mfg.py

### ISM Services

Change the `url` at the top to reflect the desired month:

    url = ".../ism-report-on-business/services/may/"

Run the script:

    python scripts/ism-srv.py

## Environments

### Development

    ┌─(venv)[stav][legion][±][trunk {1} U:3 ✗][~/.../FastHTML/crablox]

    └─▪ python --version

      Python 3.13.1

    ┌─(venv)[stav][legion][±][master ?:1 ✗][~/.../FastHTML/crablox]

    └─▪ CRB=devel python crablox/main.py

### Production

Copy `config.ini` and `data/US Stock Data 4-25-25.xlsx`.

`config.ini`:

    [CMC]

    API_KEY = 136991d4-...

    [SPEECHIFY]

    API_KEY = zBgl5nYL3T6DHa-...

    [DEFAULT]

    AUTH_USERNAME = ...

Check Python version.

    (venv) stav@bullet:.../services.pmx.mega/crablox$ python --version

      Python 3.11.2

Start the server.

    (venv) stav@bullet:.../services.pmx.mega/crablox$ PORT=5001 python crablox/main.py

## Sites

* https://docs.fastht.ml/

* https://gallery.fastht.ml/

* https://mikelev.in/futureproof/unpacking-fasthtml-databases/

* https://github.com/AnswerDotAI/fasthtml-example