Skip to main content

Xenfra CLI: Hands for AI to deploy on DigitalOcean.

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xenfra-0.4.6.tar.gz (44.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xenfra-0.4.6-py3-none-any.whl (54.8 kB view details)

Uploaded Python 3

File details

Details for the file xenfra-0.4.6.tar.gz.

File metadata

  • Download URL: xenfra-0.4.6.tar.gz
  • Upload date:
  • Size: 44.4 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for xenfra-0.4.6.tar.gz
Algorithm Hash digest
SHA256 9a789f6cee6c36d118aa4063dbb164a11c6d5236ced2a32482a2afd5afd183fc
MD5 352e37d3205e626802a2158d736a32ef
BLAKE2b-256 a2b2ae14576cb667787b06916c798fadddde858d2fffb81e10463b2b8930cbcb

See more details on using hashes here.

File details

Details for the file xenfra-0.4.6-py3-none-any.whl.

File metadata

  • Download URL: xenfra-0.4.6-py3-none-any.whl
  • Upload date:
  • Size: 54.8 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for xenfra-0.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 226cad7593bea364b5d18621ee9f8c6b2a1bcb9639c1638421187868486de214
MD5 15fa6271b9954d2bc99c3cbf9916c009
BLAKE2b-256 a5a413fb18957e342967737bf928a1325ae2dafd85e79d065a983d4b09684288

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page