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.4.tar.gz (40.2 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.4-py3-none-any.whl (48.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: xenfra-0.4.4.tar.gz
  • Upload date:
  • Size: 40.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","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.4.tar.gz
Algorithm Hash digest
SHA256 1136d4e4057fec82300d14ef82bb0d099f0d92f368c3b7aa69c47ecbff25b3ef
MD5 5f377a66a5228ac0564e9c8888dedaac
BLAKE2b-256 238325e93b7444ea9532376054d8aea32cd0d4fdede6f2d9f96b6d842f0051ec

See more details on using hashes here.

File details

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

File metadata

  • Download URL: xenfra-0.4.4-py3-none-any.whl
  • Upload date:
  • Size: 48.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 603392d8bc33589f854a790c73cc0d5e12aac95422de465a9fb6c289a905b3e2
MD5 242ae4b78fa79c3866557beaaa0f07e8
BLAKE2b-256 ac534e883fb25a4d8d9e60d4c09316e177763f36c72abdec7fdbdbcd7f40b807

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