Skip to main content

A beautiful terminal interface for Zen AI

Project description

Zen CLI

A beautiful terminal interface for Zen AI — your personal AI assistant.

Python License

Important Notice

This is a work in progress for my Jugend Forscht project. You currently can't use it without running your own Zen AI backend server which isn't publicly available yet.

✨ Features

  • 🔐 Authentication — Secure login/signup with session persistence
  • 💬 Chat — Interactive AI conversations with markdown support
  • 📝 Notes — Create, edit, search, and manage your notes
  • 🎨 Beautiful UI — Rich terminal interface with colors and arrow-key navigation

📦 Installation

pip install zen-cli

🚀 Usage

Simply run:

zen

Navigate with arrow keys (↑↓) and press Enter to select.

⚙️ Configuration

By default, Zen CLI connects to http://localhost:5000.

To use a different server, create a .env file:

ZEN_API_URL=https://your-zen-server.com

Or set the environment variable directly.

📋 Requirements

  • Python 3.10+
  • A running Zen AI backend server

🛠️ Development

Clone and install in development mode:

git clone https://github.com/joan-code6/zen_ai.git
cd zen_ai/cli
pip install -e .

📄 License

MIT License - see LICENSE file for details.

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

zen_ai_cli-1.0.1.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

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

zen_ai_cli-1.0.1-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

File details

Details for the file zen_ai_cli-1.0.1.tar.gz.

File metadata

  • Download URL: zen_ai_cli-1.0.1.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for zen_ai_cli-1.0.1.tar.gz
Algorithm Hash digest
SHA256 6df68d36a18fd317a02e2f27d5848b6520709c88f8b20b93568b39283019ce16
MD5 4c83ae37c22e5bd015d5e992b7170275
BLAKE2b-256 872fd34e14e8c3b8f1cad8d369e17bd2a3bc626ebd9d61c4233a1a0433005bd8

See more details on using hashes here.

File details

Details for the file zen_ai_cli-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: zen_ai_cli-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 16.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for zen_ai_cli-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bd65d42200ab2fca608a3204ff7b1ac73047bbcde5ffc16bf7702be2bd13568c
MD5 c22b20f38beee0ce33e87127f454d5a2
BLAKE2b-256 e1e6d65966c9f15fd235f12dd5d86a772b9268f4e4671d9da721af184b368791

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