Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Streamlit CL Forge Demo

Interactive web app showcasing CL Forge — high-performance Chilean data tools written in Rust & Python.

Open in Streamlit cl-forge Python License

Overview

This repository contains a Streamlit web application that demonstrates the capabilities of the cl-forge library. cl-forge provides a collection of high-performance utilities for common Chilean data formats and API integrations, with its core logic implemented in Rust and a clean Python interface.

The goal of this demo is to let you interact with the library's features directly in your browser — no installation required.

📖 Library docs: mschiaff.github.io/cl-forge

Live Demo

👉 Open the app — hosted on Streamlit Community Cloud.

No setup needed. Just open the link and start exploring.

Features Demonstrated

The app is organized into sections that showcase different parts of the library:

Validation

  • RUT — Calculate and validate the check digit of a Chilean RUT/RUN (national ID number) using cl_forge.verify.
  • License Plate (PPU) — Calculate and validate the check digit of Chilean vehicle license plates, with automatic format detection.

API Clients

  • CMF (Financial Market Commission) — Query real Consumer Price Index (IPC) data from the CMF API, view current values or full-year history, and toggle between table and chart views.
  • Mercado Público (Public Market) — Browse the latest government tenders and look up tender details using the Mercado Público API.

Run Locally

Prerequisites

  • Python ≥ 3.13
  • uv (recommended) or pip

Steps

# Clone the repository
git clone https://github.com/mschiaff/demo-cl-forge.git
cd demo-cl-forge

# Install dependencies
uv sync

# Run the app
demo run

# Run using uv instead of python -m
demo run --uv

# Run in detached mode (background)
demo run --detach

# Stop a detached app
demo stop

The app will open in your browser at http://localhost:8501.

Note: The CMF and Mercado Público pages require API keys to fetch live data. You can enter them in the sidebar of each page. See the cl-forge docs for details on how to obtain them.

Tech Stack

Component Technology
Core library cl-forge (Rust + Python)
Web framework Streamlit
Python ≥ 3.13
Package manager uv

License

This project is licensed under the Apache 2.0 License — see the LICENSE file for details.

Contributors

Languages