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.2.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.2-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zen_ai_cli-1.0.2.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.2.tar.gz
Algorithm Hash digest
SHA256 28c5249b221a0fdc5d0d5edc12f0b622a776b9f7f1d3bfe12629787bc0dabe65
MD5 0f0ad176d46dcfef93f553b49146e2c7
BLAKE2b-256 6912fa2673f09d68da67b1397bd04d6da631d77f044b3817544609043bab8790

See more details on using hashes here.

File details

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

File metadata

  • Download URL: zen_ai_cli-1.0.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1747127a54eaaeab99764a222bb7810ccd33dca717c7a734e86a741594823519
MD5 01eefbae18138bab02eaf21df2363cf7
BLAKE2b-256 806a6b6f9d7ef088f97c1092c27567f0514679c9fa2b59dd8e7a1fef5fa53e3e

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