🤖 Zarzor - Professional AI Terminal Tool

A powerful command-line AI assistant with persistent memory and no rols, conversation history, and seamless DeepSeek-R1 integration. Zarzor provides a professional terminal interface for AI interactions with advanced session management.

✨ Features

• 🧠 Persistent Memory: Conversations survive restarts with automatic saving
• 💬 Context-Aware: Uses previous conversation history for better responses
• 🎯 Professional CLI: Clean interface with comprehensive command system
• 📱 Cross-Platform: Works on Windows, macOS, and Linux
• 🔧 Session Management: Start new conversations, view history, clear memory
• ⚡ DeepSeek-R1 Powered: Latest AI model for high-quality responses
• 🛡️ Error Handling: Robust error handling and graceful shutdowns

🚀 Quick Start

Prerequisites

• Python 3.7 or higher
• Internet connection for AI model access

Installation

1. Clone the repository

   git clone https://github.com/MOSTRE/zarzor.git
   cd zarzor

2. Install dependencies

   pip install g4f

   Or using requirements.txt:

   pip install -r requirements.txt

3. Make executable (Linux/macOS)

   chmod +x zarzor.py

4. Run Zarzor

   python zarzor.py

   Or directly (Linux/macOS):

   ./zarzor.py

📖 Usage

Basic Usage

Start Zarzor and begin chatting:

python zarzor.py

Command Reference

Once inside Zarzor, use these commands:

Command	Description
help	Show all available commands
quit or exit	Exit Zarzor and save conversation
clear	Clear terminal screen
new	Start a new conversation
memory clear	Clear all stored memory
memory show	Show current session exchanges
memory history	Show all past conversations

Command Line Options

python zarzor.py --help                    # Show help
python zarzor.py --clear-memory            # Clear all stored memory
python zarzor.py --version                 # Show version

📁 File Structure

zarzor/
├── zarzor.py              # Main application file
├── README.md              # This file
├── requirements.txt       # Python dependencies
├── LICENSE               # MIT License
└── ~/.zarzor/            # Memory storage directory
    └── zarzor_memory.json # Conversation history

🔧 Configuration

Memory Storage

Zarzor automatically creates a .zarzor directory in your home folder:

• Linux/macOS: ~/.zarzor/zarzor_memory.json
• Windows: C:\Users\YourUsername\.zarzor\zarzor_memory.json

Memory Format

{
  "conversations": [
    {
      "id": 1,
      "started": "2024-01-01T10:00:00",
      "ended": "2024-01-01T10:30:00",
      "exchanges": [
        {
          "timestamp": "2024-01-01T10:00:00",
          "user": "Hello",
          "ai": "Hi there! How can I help you today?"
        }
      ]
    }
  ],
  "current_session": [],
  "last_updated": "2024-01-01T10:30:00"
}

🛠️ Dependencies

Required Packages

• g4f: Free GPT-4 API access

  pip install g4f

Requirements.txt

Create a requirements.txt file:

g4f>=0.2.0

🔗 Useful Links

Installation Links

• Python Download: https://python.org/downloads/
• Pip Installation: https://pip.pypa.io/en/stable/installation/
• g4f Documentation: https://github.com/xtekky/gpt4free

Python Version Check

python --version    # Should show 3.7+
pip --version      # Should show pip version

Git Installation (if needed)

• Windows: https://git-scm.com/download/win
• macOS: https://git-scm.com/download/mac
• Linux: Use your package manager (e.g., sudo apt install git)

📝 Examples

Example Session

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                   ZARZOR                                      ║
║                        Professional AI Terminal Tool                         ║
║                              Version 1.0.0                                   ║
╚═══════════════════════════════════════════════════════════════════════════════╝
Model: deepseek-r1 | Memory: 0 exchanges
Type 'help' for commands, 'quit' to exit

zarzor> Hello, what can you help me with?

Thinking...

Hello! I'm an AI here to help you with a wide variety of tasks. I can assist with:

- Answering questions on various topics
- Writing and editing text
- Code development and debugging
- Problem-solving and analysis
- Creative projects
- Research assistance
- And much more!

What would you like to work on today?

zarzor> memory show

Current Session (1 exchanges):

--- Exchange 1 ---
User: Hello, what can you help me with?
AI: Hello! I'm an AI here to help you with a wide variety of tasks. I can assist with:...

zarzor> quit
Started new conversation. Previous conversation saved.
Goodbye! Your conversation has been saved.

🐛 Troubleshooting

Common Issues

1. "g4f not found"

   pip install g4f

2. Permission denied (Linux/macOS)

   chmod +x zarzor.py

3. Python not found

   • Install Python from python.org
   • Add Python to your PATH

4. Memory file errors

   • Check write permissions in home directory
   • Try python zarzor.py --clear-memory

Debug Mode

For detailed error information, run:

python -v zarzor.py

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• Issues: GitHub Issues
• Documentation: This README
• Email: your.email@example.com

🔄 Version History

v1.0.0 (Current)

• Initial release
• DeepSeek-R1 integration
• Persistent memory system
• Professional CLI interface
• Cross-platform support

---

Made with ❤️ by MOSTRE

⭐ Star this repo if you find it helpful!