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. Currently only one testing server is available at https://raspberrypi.tailf0b36d.ts.net. If this is down, the CLI will not function.

✨ 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.3.tar.gz (28.0 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.3-py3-none-any.whl (33.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for zen_ai_cli-1.0.3.tar.gz
Algorithm Hash digest
SHA256 8e046795f58d9bb552e1602a5267d57f132dab6c0afa81f4e85b1f53cedfb005
MD5 6118103b601a5a9535498604cc3eaf37
BLAKE2b-256 885337574eee523d956a6f2fbc992a1e1937e5b7f004fb21d6bbd873ed1170ff

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for zen_ai_cli-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 cfc7aae2a6a6c592c944e80044e69ce04e2f6f65f05b10ddc374bab0024a5e52
MD5 bf7ee9ac35e49aba8d9d7e3bccfd7c9b
BLAKE2b-256 4bae0f45959a6f2d1b41fe84fa5e7df2c50ba5c1bbd86ea5c977419e5c6f8c42

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