zeta-cli 1.0.0

ZETA - Zero-Latency Editing Terminal Agent: A friendly local AI terminal agent

ZETA - Zero-Latency Editing Terminal Agent

ZETA is a friendly, local AI terminal agent designed for non-technical users. It runs completely offline using Ollama with the MiniMax M2 model, making it perfect for learning to code without relying on external APIs.

✨ Features

🎯 Ask → Act → Explain Flow

• Smart Clarification: Detects vague inputs and asks helpful clarifying questions with numbered options
• Safe Operations: Never edits files without your confirmation
• Plain English Explanations: Every action is explained in simple, understandable terms
• Learning Log: All interactions are logged to zeta_log.md for your learning journey

📚 Teaching Mode

• Toggle with --teach flag or use zeta teach command
• Detailed explanations with definitions (e.g., "HTML is the skeleton of a webpage")
• Interactive learning sessions

🔍 Critic Loop (Optional)

• Enable with --critic flag
• Reviews code for bugs, style, and security issues
• Provides scores (1-10) and suggests fixes for scores below 8

🛠️ Powerful Tools

• ReadFile: Read any file in your project
• WriteFile: Create or edit files (with automatic parent directory creation)
• RunCommand: Execute shell commands safely
• ListFiles: Browse your project structure

🚀 Installation

Prerequisites

1. Python 3.8+ installed
2. Ollama installed and running
3. MiniMax M2 model pulled in Ollama:

   ollama pull minimax-m2:cloud
   

Install ZETA

# Clone or download this repository
cd zeta_cli

# Install in development mode
pip install -e .

# Or install dependencies manually
pip install click langchain-ollama langchain langgraph rich

📖 Usage

Basic Commands

# Run a task
zeta run "make a to-do app"

# With teaching mode
zeta run "create a calculator" --teach

# With critic mode
zeta run "write a Python script" --critic

# Combine both modes
zeta run "build a webpage" --teach --critic

# Interactive teaching session
zeta teach

# View your learning log
zeta log

Example Flow

$ zeta run "make a to-do app"

🤔 I need a bit more information!

What kind of to-do app would you like?

  1. A simple HTML webpage with JavaScript
  2. A Python terminal application
  3. A command-line tool

Choose an option [1]: 1

Great choice! Let's make a simple HTML webpage with JavaScript.

[ZETA processes your request...]

[Displays created files and explanation]

Would you like to learn how this works? [y/N]: y

[Shows detailed lesson about HTML and JavaScript]

🎓 Teaching Mode Examples

Basic Teaching Session

$ zeta teach

📚 Teaching Mode
Learn coding concepts in detail

What would you like to learn about?
Type 'exit' to end the session

You: What is HTML?
📖 Lesson: HTML stands for HyperText Markup Language. Think of it as the skeleton 
of a webpage - it defines the structure and content...

You: How does JavaScript work?
📖 Lesson: JavaScript is like the brain of your webpage. It makes things interactive...

Teaching Mode with Tasks

$ zeta run "create a button" --teach

[Creates button.html]

Explanation: I created an HTML file with a button element. HTML uses tags like 
<button> to create interactive elements. The button I created will display 
"Click me!" when viewed in a browser. When teaching mode is enabled, I'll explain 
that HTML provides structure, while JavaScript (which we can add) makes it do 
things when clicked.

Would you like to learn how this works? [y/N]: y

🔍 Critic Mode

When enabled, ZETA reviews your code:

$ zeta run "write a Python function to add numbers" --critic

[Creates add.py]

Code Review:
Score: 7/10

Issues:
- Missing type hints
- No error handling for non-numeric inputs

Suggestions:
- Add type hints: def add(a: int, b: int) -> int:
- Add try/except for invalid inputs

Would you like me to fix these issues? [y/N]

📝 Learning Log

All your interactions are saved to zeta_log.md:

## 2024-01-15 14:30:22

**Action:** User task: make a to-do app

**Explanation:** I created a simple HTML to-do app with a clean interface...

**Lesson:** HTML provides structure, CSS makes it pretty, and JavaScript 
makes it interactive. Think of it like building a house: HTML is the frame, 
CSS is the paint, and JavaScript is the electricity that makes lights work.

---

View your log anytime:

zeta log

🏗️ Project Structure

zeta_cli/
├── zeta.py          # Main CLI application
├── setup.py         # Installation configuration
├── README.md        # This file
└── zeta_log.md      # Auto-generated learning log

🔧 Configuration

ZETA uses the Ollama model minimax-m2:cloud by default. To use a different model, edit the MODEL_NAME constant in zeta.py:

MODEL_NAME = "your-model-name"

🎨 Features in Detail

1. Vague Task Detection

ZETA automatically detects when your request is too vague:

$ zeta run "make a chatbot"
🤔 I need a bit more information!

What kind of chatbot would you like?
  1. A simple terminal-based chatbot
  2. A web-based chatbot with HTML interface
  3. A Python script chatbot

2. Safe File Operations

ZETA never modifies files without confirmation:

[Before writing file.html]
Would you like me to create/modify file.html? [y/N]: y
✓ File created successfully!

3. Encouraging Language

ZETA uses friendly, encouraging messages:

• "Great choice!"
• "Nice! Your app is live."
• "Let's do this!"
• "Awesome work!"

4. Plain English Explanations

No jargon without explanation:

• ❌ "Created a REST API endpoint"
• ✅ "Created a REST API endpoint - that's like a mailbox where your app can receive requests and send back data"

🐛 Troubleshooting

Ollama Connection Issues

If you see connection errors:

1. Make sure Ollama is running: ollama serve
2. Verify the model is installed: ollama list
3. Pull the model if needed: ollama pull minimax-m2:cloud

Model Not Found

If the model isn't available:

# List available models
ollama list

# Pull the MiniMax M2 model
ollama pull minimax-m2:cloud

# Or use a different model by editing zeta.py

🤝 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

📄 License

MIT License - feel free to use ZETA for any purpose.

🙏 Acknowledgments

• Built with LangChain and LangGraph
• Powered by Ollama
• Beautiful CLI with Rich
• CLI framework: Click

💡 Tips for Non-Technical Users

1. Start Simple: Begin with basic tasks like "create a text file" or "make a simple webpage"
2. Use Teaching Mode: Always use --teach when learning something new
3. Ask Questions: ZETA loves to explain! Ask "what is X?" anytime
4. Review Your Log: Check zeta log regularly to review what you've learned
5. Be Specific: The more details you provide, the better ZETA can help

---

Happy Coding! 🚀

Remember: Every expert was once a beginner. ZETA is here to help you learn at your own pace!