Skip to main content

Xenfra CLI (The Interface) 🖥️

PyPI License: MIT

The official command-line interface for Xenfra (The Sovereign Cloud OS). It empowers developers to deploy, monitor, and manage applications on their own infrastructure (DigitalOcean) with the ease of Heroku.

🚀 Features

  • Zero-Config Deployment: xenfra deploy detects your stack (Python, Node.js) and ships it.
  • Sovereign Auth: xenfra auth login connects securely to your cloud provider.
  • Live Logs: xenfra logs streams colorized, PII-scrubbed logs from your servers.
  • Doctor: xenfra doctor runs a battery of health checks on your deployment environment.
  • Zen Mode: Automatically applies fix patches when deployments fail.

📦 Installation

# Recommended: Install via uv
uv tool install xenfra

# Or via pip
pip install xenfra

🛠️ Quick Start

1. Login

Authenticate with your cloud provider (DigitalOcean via Xenfra Platform).

xenfra auth login

2. Deploy Your App

Navigate to your project directory and blast off.

cd ~/my-projects/awesome-api
xenfra deploy

That's it. Xenfra handles Dockerfile generation, server provisioning, SSL (Caddy), and database connections.

3. Check Status

xenfra status

🎛️ Command Reference

Command Description
xenfra auth login Start the OAuth flow
xenfra deploy Deploy current directory
xenfra logs Tail logs (Ctrl+C to stop)
xenfra status Show health metrics (CPU/RAM)
xenfra list List all your projects
xenfra init Generate config files without deploying

🔗 The Xenfra Ecosystem

This CLI is the "Interface" of the Xenfra Open Core architecture:

  • xenfra-sdk: The Core Engine (Used by this CLI).
  • xenfra-mcp: The AI Agent Interface.
  • xenfra-platform: The Private SaaS Backend.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

📄 License

MIT © Xenfra Cloud

Metadata

Release files for xenfra 0.4.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xenfra 0.4.6
File Size Uploaded
xenfra-0.4.6.tar.gz 44.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xenfra 0.4.6
File Interpreter ABI Platform
xenfra-0.4.6-py3-none-any.whl Python 3 none any Details

Total release size: 99.2 kB

Release files / xenfra-0.4.6.tar.gz

Download URL xenfra-0.4.6.tar.gz
Size 44.4 kB
Tags Source
SHA-256 checksum
How to use checksums
9a789f6cee6c36d118aa4063dbb164a11c6d5236ced2a32482a2afd5afd183fc
BLAKE2b-256 checksum
How to use checksums
a2b2ae14576cb667787b06916c798fadddde858d2fffb81e10463b2b8930cbcb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / xenfra-0.4.6-py3-none-any.whl

Download URL xenfra-0.4.6-py3-none-any.whl
Size 54.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
226cad7593bea364b5d18621ee9f8c6b2a1bcb9639c1638421187868486de214
BLAKE2b-256 checksum
How to use checksums
a5a413fb18957e342967737bf928a1325ae2dafd85e79d065a983d4b09684288
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.4.6 This release

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page