quickcap 0.0.1

Simple lib to deploy app using caprover

quickcap

Installation

pip install quickcap

Usage

Login

import os

caprover_server = os.environ.get("CAPROVER_SERVER") 
caprover_password =os.environ.get("CAPROVER_PASSWORD") 

token = caplogin(caprover_server, caprover_password)

Create a webcam app

First, create your app in a Python file:

example_app = """from fasthtml.common import *

app = FastHTML()

@app.route("/")
def home(): return Div(H1("Hello World!"), P("Deployed with CapRover API"))

serve()
"""

from pathlib import Path 
Path("myapp.py").write_text(example_app)

150

Setup and deploy

Create the app on CapRover with SSL and optional configuration:

app_name = "myapp"

setup_app(caprover_server, token, app_name, env_vars={"MY_SECRET": "supersecret123"})

{'status': 100, 'description': 'Updated App Definition Saved', 'data': {}}

Deploy your script:

# requirements: python package used by your app
requirements = ["python-fasthtml"]

deploy(caprover_server, token, app_name, "myapp.py", requirements)

{'status': 100, 'description': 'Deploy is done', 'data': {}}

Your app is now live at https://myapp.yourdomain.com!

Check logs

Runtime logs:

print(get_app_logs(caprover_server, token, app_name))

\x00\x00\x00\x00\x00\x00_2025-11-28T15:41:48.432303544Z INFO:     Will watch for changes in these directories: ['/app']
\x00\x00\x00\x00\x00\x00e2025-11-28T15:41:48.433467344Z INFO:     Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)
\x00\x00\x00\x00\x00\x00W2025-11-28T15:41:48.433563845Z INFO:     Started reloader process [1] using WatchFiles

\x00\x00\x00\x00\x00\x0092025-11-28T15:41:48.439627618Z Link: http://localhost:80
\x00\x00\x00\x00\x00\x00D2025-11-28T15:41:48.885448868Z INFO:     Started server process [8]
\x00\x00\x00\x00\x00\x00J2025-11-28T15:41:48.885498426Z INFO:     Waiting for application startup.
\x00\x00\x00\x00\x00\x00G2025-11-28T15:41:48.885684464Z INFO:     Application startup complete.

\x00\x00\x00\x00\x00\x00R2025-11-28T15:41:56.441328792Z INFO:     10.0.1.5:56602 - "GET / HTTP/1.0" 200 OK

\x00\x00\x00\x00\x00\x00d2025-11-28T15:41:56.618178234Z INFO:     10.0.1.5:56612 - "GET /favicon.ico HTTP/1.0" 404 Not Found

Delete an app

delete_app(caprover_server, token, app_name)

{'status': 100, 'description': 'App is deleted', 'data': {}}

API Reference

Function	Description
caplogin	Login and get authentication token
setup_app	Create app with SSL and configuration (recommended)
deploy	Build and deploy FastHTML app from script(s)
get_app_logs	Get runtime logs
get_app_deployment_logs	Get build logs
delete_app	Remove an app
create_app	Register a new app (low-level)
update_app	Update app configuration (low-level)
enable_ssl	Enable HTTPS for an app (low-level)
upload_app	Upload tar.gz archive (low-level)