# ZETA CLI
**ZETA CLI — the most accessible AI terminal agent for learning and building.**
[](https://pypi.org/project/zeta-cli/)
[](LICENSE)
[](https://www.python.org/downloads/)
[](CONTRIBUTING.md)
ZETA CLI is an AI-powered terminal agent that makes coding accessible to everyone. Whether you're learning to code or building projects, ZETA helps you accomplish tasks through natural language interaction with multiple LLM providers.
## Motivation
Coding should be accessible to everyone, regardless of technical background. ZETA CLI bridges the gap between intent and implementation by providing an intelligent terminal agent that understands natural language and executes tasks safely. With support for multiple AI providers and built-in learning features, ZETA empowers users to learn coding concepts while building real projects.
## Installation
### From PyPI (Recommended)
```bash
pip install zeta-cli
```
### Using uv
```bash
uv tool install zeta-cli
```
### From Source
```bash
git clone https://github.com/SukinShetty/Zeta-CLI.git
cd Zeta-CLI
pip install -e .
```
## Quickstart
### 1. Choose Your Working Directory
**Important:** ZETA creates files in your current directory. Before running commands, navigate to a folder where you want your files created.
**Windows:**
```powershell
# Navigate to Desktop (recommended for beginners)
cd $env:USERPROFILE\Desktop
# Or navigate to Documents
cd $env:USERPROFILE\Documents
# Or create a new project folder
cd $env:USERPROFILE\Desktop
mkdir MyProjects
cd MyProjects
```
**Mac/Linux:**
```bash
# Navigate to Desktop
cd ~/Desktop
# Or navigate to Documents
cd ~/Documents
# Or create a new project folder
cd ~/Desktop
mkdir MyProjects
cd MyProjects
```
**Check your current directory:**
- Windows: `pwd` or `Get-Location`
- Mac/Linux: `pwd`
**Why this matters:** Files created by ZETA will appear in whatever folder you're currently in. Using Desktop or Documents makes it easy to find your files later.
### 2. Setup
Configure your preferred AI provider:
```bash
zeta setup
```
This interactive wizard helps you set up:
- Google Gemini (free tier available)
- OpenAI (GPT-4, GPT-3.5)
- Anthropic Claude
- Ollama (local models)
### 3. Run Your First Task
```bash
zeta run "say hello"
```
ZETA will process your request and execute the task.
### 4. Teaching Mode
Get detailed explanations of coding concepts:
```bash
zeta teach
```
Or enable teaching mode for specific tasks:
```bash
zeta run "create a calculator" --teach
```
### 5. View Learning Log
Track your coding journey:
```bash
zeta log
```
### Complete Example
```bash
# 1. Navigate to your project folder (IMPORTANT!)
cd ~/Desktop # Mac/Linux
# or
cd $env:USERPROFILE\Desktop # Windows
# 2. Setup (first time only)
zeta setup
# 3. Run a task (files will be created in current folder)
zeta run "create a simple to-do app"
# 4. Run with teaching mode
zeta run "build a REST API" --teach
# 5. Run with code review
zeta run "write a Python function" --critic
# 6. View your learning history
zeta log
```
**Finding Your Files:** After ZETA creates files, they'll be in the folder you navigated to in step 1. On Windows, check your Desktop. On Mac/Linux, check your Desktop folder.
## Supported Providers
ZETA CLI supports multiple LLM providers, giving you flexibility and choice:
| Provider | Model Examples | Setup Required |
|----------|---------------|----------------|
| **Google Gemini** | `gemini-1.5-flash`, `gemini-1.5-pro` | API key (free tier available) |
| **OpenAI** | `gpt-4o-mini`, `gpt-4`, `gpt-3.5-turbo` | API key |
| **Anthropic Claude** | `claude-3-5-sonnet-20241022` | API key |
| **Ollama** | Any local model (e.g., `llama3.2`, `mistral`) | Ollama installed locally |
Run `zeta setup` to configure your preferred provider. You can switch providers at any time by running the setup command again.
## Features
- **Multi-Provider Support**: Choose from Google Gemini, OpenAI, Anthropic Claude, or local Ollama
- **Smart Clarification**: Automatically detects vague requests and asks helpful questions
- **Teaching Mode**: Detailed explanations with plain English definitions
- **Code Review**: Optional critic mode for quality and security checks
- **Learning Log**: Automatic tracking of your coding journey
- **Safe Operations**: File operations require confirmation before execution
## Troubleshooting
### Files Not Being Created
If ZETA says it created files but you can't find them:
1. **Check your current directory:**
```powershell
# Windows
Get-Location
# Mac/Linux
pwd
```
2. **Navigate to a proper folder before running ZETA:**
```powershell
# Windows - go to Desktop
cd $env:USERPROFILE\Desktop
# Mac/Linux - go to Desktop
cd ~/Desktop
```
3. **Avoid system directories** like `C:\WINDOWS\system32` - these require administrator permissions.
4. **Find your files:** After running ZETA, check the folder you navigated to. Files will be created there.
### Command Not Found (Windows)
If `zeta` command is not found on Windows:
```powershell
# Use Python module instead
python -m zeta run "task"
```
### Provider Connection Issues
**Google Gemini / OpenAI / Anthropic:**
- Verify your API key is set correctly: `zeta setup`
- Check your internet connection
- Ensure you have available API quota
**Ollama:**
- Ensure Ollama is running: `ollama serve`
- Verify model is pulled: `ollama list`
- Check Ollama is accessible: `curl http://localhost:11434/api/tags`
### Configuration Not Persisting
If settings don't persist between sessions:
```bash
# Check configuration file
cat ~/.zeta_config.json
# Re-run setup
zeta setup
```
### Model Not Found
If you see "model not found" errors:
- **Google Gemini**: Use `gemini-1.5-flash` or `gemini-1.5-pro` (without `-latest` suffix)
- **OpenAI**: Use `gpt-4o-mini` or `gpt-4`
- **Ollama**: Pull the model first: `ollama pull llama3.2`
## Roadmap
### Plugins
Plugin system for custom tools and extensions, enabling community-contributed functionality.
### Cloud
Cloud-hosted ZETA instances for teams and organizations, with shared configurations and collaboration features.
### Pro
Advanced features including:
- Custom model fine-tuning
- Extended context windows
- Priority support
- Advanced analytics
### Enterprise
Enterprise-grade features:
- Self-hosted deployments
- SSO integration
- Audit logs
- Compliance certifications
- Dedicated support
### Store
Marketplace for:
- Pre-built project templates
- Custom tool integrations
- Provider configurations
- Learning modules
## Contributing
We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
### Quick Contribution Guide
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/your-feature`
3. Make your changes
4. Run tests: `pytest tests/ -v`
5. Commit: `git commit -m "Add your feature"`
6. Push: `git push origin feature/your-feature`
7. Open a Pull Request
## License
Licensed under the Apache License 2.0. See [LICENSE](LICENSE) for details.
## Links
- **PyPI Package**: https://pypi.org/project/zeta-cli/
- **GitHub Repository**: https://github.com/SukinShetty/Zeta-CLI
- **Issues**: https://github.com/SukinShetty/Zeta-CLI/issues
- **Discussions**: https://github.com/SukinShetty/Zeta-CLI/discussions
## Acknowledgments
Built with:
- [LangChain](https://www.langchain.com/) and [LangGraph](https://github.com/langchain-ai/langgraph) for LLM orchestration
- [Rich](https://github.com/Textualize/rich) for beautiful terminal output
- [Click](https://click.palletsprojects.com/) for CLI framework
---
**Copyright 2025 Sukin Shetty**
Raw data
{
"_id": null,
"home_page": "https://github.com/SukinShetty/Zeta-CLI",
"name": "zeta-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cli, ai, terminal, agent, llm, langchain",
"author": "Sukin Shetty",
"author_email": "Sukin Shetty <sukin.shetty8@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/4e/9e/73d13ce9f3b4733ce8327b4cfaf64cadcd3f871c47214c9b1d3428a4f810/zeta_cli-1.0.7.tar.gz",
"platform": null,
"description": "# ZETA CLI\r\n\r\n**ZETA CLI \u2014 the most accessible AI terminal agent for learning and building.**\r\n\r\n[](https://pypi.org/project/zeta-cli/)\r\n[](LICENSE)\r\n[](https://www.python.org/downloads/)\r\n[](CONTRIBUTING.md)\r\n\r\nZETA CLI is an AI-powered terminal agent that makes coding accessible to everyone. Whether you're learning to code or building projects, ZETA helps you accomplish tasks through natural language interaction with multiple LLM providers.\r\n\r\n## Motivation\r\n\r\nCoding should be accessible to everyone, regardless of technical background. ZETA CLI bridges the gap between intent and implementation by providing an intelligent terminal agent that understands natural language and executes tasks safely. With support for multiple AI providers and built-in learning features, ZETA empowers users to learn coding concepts while building real projects.\r\n \r\n## Installation\r\n\r\n### From PyPI (Recommended)\r\n\r\n```bash\r\npip install zeta-cli\r\n```\r\n\r\n### Using uv\r\n\r\n```bash\r\nuv tool install zeta-cli\r\n```\r\n\r\n### From Source\r\n\r\n```bash\r\ngit clone https://github.com/SukinShetty/Zeta-CLI.git\r\ncd Zeta-CLI\r\npip install -e .\r\n```\r\n\r\n## Quickstart\r\n\r\n### 1. Choose Your Working Directory\r\n\r\n**Important:** ZETA creates files in your current directory. Before running commands, navigate to a folder where you want your files created.\r\n\r\n**Windows:**\r\n```powershell\r\n# Navigate to Desktop (recommended for beginners)\r\ncd $env:USERPROFILE\\Desktop\r\n\r\n# Or navigate to Documents\r\ncd $env:USERPROFILE\\Documents\r\n\r\n# Or create a new project folder\r\ncd $env:USERPROFILE\\Desktop\r\nmkdir MyProjects\r\ncd MyProjects\r\n```\r\n\r\n**Mac/Linux:**\r\n```bash\r\n# Navigate to Desktop\r\ncd ~/Desktop\r\n\r\n# Or navigate to Documents\r\ncd ~/Documents\r\n\r\n# Or create a new project folder\r\ncd ~/Desktop\r\nmkdir MyProjects\r\ncd MyProjects\r\n```\r\n\r\n**Check your current directory:**\r\n- Windows: `pwd` or `Get-Location`\r\n- Mac/Linux: `pwd`\r\n\r\n**Why this matters:** Files created by ZETA will appear in whatever folder you're currently in. Using Desktop or Documents makes it easy to find your files later.\r\n\r\n### 2. Setup\r\n\r\nConfigure your preferred AI provider:\r\n\r\n```bash\r\nzeta setup\r\n```\r\n\r\nThis interactive wizard helps you set up:\r\n- Google Gemini (free tier available)\r\n- OpenAI (GPT-4, GPT-3.5)\r\n- Anthropic Claude\r\n- Ollama (local models)\r\n\r\n### 3. Run Your First Task\r\n\r\n```bash\r\nzeta run \"say hello\"\r\n```\r\n\r\nZETA will process your request and execute the task.\r\n\r\n### 4. Teaching Mode\r\n\r\nGet detailed explanations of coding concepts:\r\n\r\n```bash\r\nzeta teach\r\n```\r\n\r\nOr enable teaching mode for specific tasks:\r\n\r\n```bash\r\nzeta run \"create a calculator\" --teach\r\n```\r\n\r\n### 5. View Learning Log\r\n\r\nTrack your coding journey:\r\n\r\n```bash\r\nzeta log\r\n```\r\n\r\n### Complete Example\r\n\r\n```bash\r\n# 1. Navigate to your project folder (IMPORTANT!)\r\ncd ~/Desktop # Mac/Linux\r\n# or\r\ncd $env:USERPROFILE\\Desktop # Windows\r\n\r\n# 2. Setup (first time only)\r\nzeta setup\r\n\r\n# 3. Run a task (files will be created in current folder)\r\nzeta run \"create a simple to-do app\"\r\n\r\n# 4. Run with teaching mode\r\nzeta run \"build a REST API\" --teach\r\n\r\n# 5. Run with code review\r\nzeta run \"write a Python function\" --critic\r\n\r\n# 6. View your learning history\r\nzeta log\r\n```\r\n\r\n**Finding Your Files:** After ZETA creates files, they'll be in the folder you navigated to in step 1. On Windows, check your Desktop. On Mac/Linux, check your Desktop folder.\r\n\r\n## Supported Providers\r\n\r\nZETA CLI supports multiple LLM providers, giving you flexibility and choice:\r\n\r\n| Provider | Model Examples | Setup Required |\r\n|----------|---------------|----------------|\r\n| **Google Gemini** | `gemini-1.5-flash`, `gemini-1.5-pro` | API key (free tier available) |\r\n| **OpenAI** | `gpt-4o-mini`, `gpt-4`, `gpt-3.5-turbo` | API key |\r\n| **Anthropic Claude** | `claude-3-5-sonnet-20241022` | API key |\r\n| **Ollama** | Any local model (e.g., `llama3.2`, `mistral`) | Ollama installed locally |\r\n\r\nRun `zeta setup` to configure your preferred provider. You can switch providers at any time by running the setup command again.\r\n\r\n## Features\r\n\r\n- **Multi-Provider Support**: Choose from Google Gemini, OpenAI, Anthropic Claude, or local Ollama\r\n- **Smart Clarification**: Automatically detects vague requests and asks helpful questions\r\n- **Teaching Mode**: Detailed explanations with plain English definitions\r\n- **Code Review**: Optional critic mode for quality and security checks\r\n- **Learning Log**: Automatic tracking of your coding journey\r\n- **Safe Operations**: File operations require confirmation before execution\r\n\r\n## Troubleshooting\r\n\r\n### Files Not Being Created\r\n\r\nIf ZETA says it created files but you can't find them:\r\n\r\n1. **Check your current directory:**\r\n ```powershell\r\n # Windows\r\n Get-Location\r\n \r\n # Mac/Linux\r\n pwd\r\n ```\r\n\r\n2. **Navigate to a proper folder before running ZETA:**\r\n ```powershell\r\n # Windows - go to Desktop\r\n cd $env:USERPROFILE\\Desktop\r\n \r\n # Mac/Linux - go to Desktop\r\n cd ~/Desktop\r\n ```\r\n\r\n3. **Avoid system directories** like `C:\\WINDOWS\\system32` - these require administrator permissions.\r\n\r\n4. **Find your files:** After running ZETA, check the folder you navigated to. Files will be created there.\r\n\r\n### Command Not Found (Windows)\r\n\r\nIf `zeta` command is not found on Windows:\r\n\r\n```powershell\r\n# Use Python module instead\r\npython -m zeta run \"task\"\r\n```\r\n\r\n### Provider Connection Issues\r\n\r\n**Google Gemini / OpenAI / Anthropic:**\r\n- Verify your API key is set correctly: `zeta setup`\r\n- Check your internet connection\r\n- Ensure you have available API quota\r\n\r\n**Ollama:**\r\n- Ensure Ollama is running: `ollama serve`\r\n- Verify model is pulled: `ollama list`\r\n- Check Ollama is accessible: `curl http://localhost:11434/api/tags`\r\n\r\n### Configuration Not Persisting\r\n\r\nIf settings don't persist between sessions:\r\n\r\n```bash\r\n# Check configuration file\r\ncat ~/.zeta_config.json\r\n\r\n# Re-run setup\r\nzeta setup\r\n```\r\n\r\n### Model Not Found\r\n\r\nIf you see \"model not found\" errors:\r\n\r\n- **Google Gemini**: Use `gemini-1.5-flash` or `gemini-1.5-pro` (without `-latest` suffix)\r\n- **OpenAI**: Use `gpt-4o-mini` or `gpt-4`\r\n- **Ollama**: Pull the model first: `ollama pull llama3.2`\r\n\r\n## Roadmap\r\n\r\n### Plugins\r\nPlugin system for custom tools and extensions, enabling community-contributed functionality.\r\n\r\n### Cloud\r\nCloud-hosted ZETA instances for teams and organizations, with shared configurations and collaboration features.\r\n\r\n### Pro\r\nAdvanced features including:\r\n- Custom model fine-tuning\r\n- Extended context windows\r\n- Priority support\r\n- Advanced analytics\r\n\r\n### Enterprise\r\nEnterprise-grade features:\r\n- Self-hosted deployments\r\n- SSO integration\r\n- Audit logs\r\n- Compliance certifications\r\n- Dedicated support\r\n\r\n### Store\r\nMarketplace for:\r\n- Pre-built project templates\r\n- Custom tool integrations\r\n- Provider configurations\r\n- Learning modules\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\r\n\r\n### Quick Contribution Guide\r\n\r\n1. Fork the repository\r\n2. Create a feature branch: `git checkout -b feature/your-feature`\r\n3. Make your changes\r\n4. Run tests: `pytest tests/ -v`\r\n5. Commit: `git commit -m \"Add your feature\"`\r\n6. Push: `git push origin feature/your-feature`\r\n7. Open a Pull Request\r\n\r\n## License\r\n\r\nLicensed under the Apache License 2.0. See [LICENSE](LICENSE) for details.\r\n\r\n## Links\r\n\r\n- **PyPI Package**: https://pypi.org/project/zeta-cli/\r\n- **GitHub Repository**: https://github.com/SukinShetty/Zeta-CLI\r\n- **Issues**: https://github.com/SukinShetty/Zeta-CLI/issues\r\n- **Discussions**: https://github.com/SukinShetty/Zeta-CLI/discussions\r\n\r\n## Acknowledgments\r\n\r\nBuilt with:\r\n- [LangChain](https://www.langchain.com/) and [LangGraph](https://github.com/langchain-ai/langgraph) for LLM orchestration\r\n- [Rich](https://github.com/Textualize/rich) for beautiful terminal output\r\n- [Click](https://click.palletsprojects.com/) for CLI framework\r\n\r\n---\r\n\r\n**Copyright 2025 Sukin Shetty**\r\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "ZETA: the most accessible AI terminal agent.",
"version": "1.0.7",
"project_urls": {
"Documentation": "https://github.com/SukinShetty/Zeta-CLI#readme",
"Homepage": "https://github.com/SukinShetty/Zeta-CLI",
"Issues": "https://github.com/SukinShetty/Zeta-CLI/issues",
"Repository": "https://github.com/SukinShetty/Zeta-CLI"
},
"split_keywords": [
"cli",
" ai",
" terminal",
" agent",
" llm",
" langchain"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a76fb28b90623fba530f5ebe97212579a7b56c35ecd16d6d6446e0197568c08e",
"md5": "a405d17918805631408a5ffd96955392",
"sha256": "61978aef106ec385c64a6af36abd4aeacc35175707a6d58e0054cf53ee811348"
},
"downloads": -1,
"filename": "zeta_cli-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a405d17918805631408a5ffd96955392",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 34330,
"upload_time": "2025-11-05T10:17:36",
"upload_time_iso_8601": "2025-11-05T10:17:36.132292Z",
"url": "https://files.pythonhosted.org/packages/a7/6f/b28b90623fba530f5ebe97212579a7b56c35ecd16d6d6446e0197568c08e/zeta_cli-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4e9e73d13ce9f3b4733ce8327b4cfaf64cadcd3f871c47214c9b1d3428a4f810",
"md5": "905d00ef28bb775b37f1bb57fab05630",
"sha256": "431bc225200d26e0fc64d921210a8eb6f84aa604861c783976aea1426b00ba71"
},
"downloads": -1,
"filename": "zeta_cli-1.0.7.tar.gz",
"has_sig": false,
"md5_digest": "905d00ef28bb775b37f1bb57fab05630",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 47622,
"upload_time": "2025-11-05T10:17:37",
"upload_time_iso_8601": "2025-11-05T10:17:37.593305Z",
"url": "https://files.pythonhosted.org/packages/4e/9e/73d13ce9f3b4733ce8327b4cfaf64cadcd3f871c47214c9b1d3428a4f810/zeta_cli-1.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-05 10:17:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SukinShetty",
"github_project": "Zeta-CLI",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "zeta-cli"
}
JSON
