dwarp 0.1.7__tar.gz

dwarp-0.1.7/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: dwarp
+Version: 0.1.7
+Summary: Terminal assistant built as an open source minimal alternative to Warp
+Author-email: Abhinav <abhinavkumarsingh2023@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Abhinavexists/dwarp
+Project-URL: Repository, https://github.com/Abhinavexists/dwarp.git
+Project-URL: Issues, https://github.com/Abhinavexists/dwarp/issues
+Keywords: terminal,ai,shell,assistant,cli,gemini
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: prompt-toolkit==3.0.51
+Requires-Dist: rich==14.1.0
+Requires-Dist: pydantic==2.11.7
+Requires-Dist: python-dotenv==1.1.1
+Requires-Dist: google-genai==1.31.0
+
+# Dwarp
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)](https://github.com/your-username/ai-enabled-terminal)
+
+Terminal assistant built as an open source minimal alternative to Warp.
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12 or higher
+- Linux operating system (Ubuntu, Arch, Fedora, CentOS, openSUSE, Debian supported) (Windows and MacOS will be supproted later on)
+- Google Gemini API key ([Get one here](https://aistudio.google.com/app/apikey))
+
+### Installation
+
+#### Option 1: Binary Release (Recommended)
+
+1. Download the latest release from [Releases](https://github.com/Abhinavexists/dwarp/releases)
+2. Extract and install:
+
+   ```bash
+   tar -xzf dwarp-linux.tar.gz
+   cd dwarp-linux
+   sudo ./install.sh
+   ```
+
+3. Launch the terminal:
+
+   ```bash
+   dwarp
+   ```
+
+4. Enter your Gemini API key when prompted
+
+#### Option 2: From Source
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/Abhinavexists/dwarp.git
+   cd dwarp
+   ```
+
+2. Create and activate virtual environment:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. Install dependencies:
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+4. Set up your API key:
+
+   ```bash
+   export GEMINI_API_KEY="your-api-key-here"
+   ```
+
+5. Run the application:
+
+   ```bash
+   python -m terminal.cli
+   ```
+
+## Usage Examples
+
+```bash
+# Natural language commands
+> install docker
+Command: sudo pacman -S docker
+Explanation: Installs Docker using the system package manager
+
+> find all python files in current directory
+Command: find . -name "*.py" -type f
+Explanation: Searches for all Python files in the current directory and subdirectories
+
+> compress folder into zip
+Command: zip -r archive.zip folder_name
+Explanation: Creates a ZIP archive of the specified folder
+
+> show disk usage sorted by size
+Command: du -sh * | sort -hr
+Explanation: Shows disk usage of all items in current directory, sorted by size
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## Pending stuff
+
+- [ ] Support for Windows and macOS
+- [ ] Custom command templates and aliases
+- [ ] Plugin system for extending functionality
+- [ ] Command explanation and learning mode
+- [ ] Integration with popular development tools
+- [ ] Multi-language support
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

dwarp-0.1.7/README.md

@@ -0,0 +1,108 @@
+# Dwarp
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)](https://github.com/your-username/ai-enabled-terminal)
+
+Terminal assistant built as an open source minimal alternative to Warp.
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12 or higher
+- Linux operating system (Ubuntu, Arch, Fedora, CentOS, openSUSE, Debian supported) (Windows and MacOS will be supproted later on)
+- Google Gemini API key ([Get one here](https://aistudio.google.com/app/apikey))
+
+### Installation
+
+#### Option 1: Binary Release (Recommended)
+
+1. Download the latest release from [Releases](https://github.com/Abhinavexists/dwarp/releases)
+2. Extract and install:
+
+   ```bash
+   tar -xzf dwarp-linux.tar.gz
+   cd dwarp-linux
+   sudo ./install.sh
+   ```
+
+3. Launch the terminal:
+
+   ```bash
+   dwarp
+   ```
+
+4. Enter your Gemini API key when prompted
+
+#### Option 2: From Source
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/Abhinavexists/dwarp.git
+   cd dwarp
+   ```
+
+2. Create and activate virtual environment:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. Install dependencies:
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+4. Set up your API key:
+
+   ```bash
+   export GEMINI_API_KEY="your-api-key-here"
+   ```
+
+5. Run the application:
+
+   ```bash
+   python -m terminal.cli
+   ```
+
+## Usage Examples
+
+```bash
+# Natural language commands
+> install docker
+Command: sudo pacman -S docker
+Explanation: Installs Docker using the system package manager
+
+> find all python files in current directory
+Command: find . -name "*.py" -type f
+Explanation: Searches for all Python files in the current directory and subdirectories
+
+> compress folder into zip
+Command: zip -r archive.zip folder_name
+Explanation: Creates a ZIP archive of the specified folder
+
+> show disk usage sorted by size
+Command: du -sh * | sort -hr
+Explanation: Shows disk usage of all items in current directory, sorted by size
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## Pending stuff
+
+- [ ] Support for Windows and macOS
+- [ ] Custom command templates and aliases
+- [ ] Plugin system for extending functionality
+- [ ] Command explanation and learning mode
+- [ ] Integration with popular development tools
+- [ ] Multi-language support
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

dwarp-0.1.7/dwarp.egg-info/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: dwarp
+Version: 0.1.7
+Summary: Terminal assistant built as an open source minimal alternative to Warp
+Author-email: Abhinav <abhinavkumarsingh2023@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Abhinavexists/dwarp
+Project-URL: Repository, https://github.com/Abhinavexists/dwarp.git
+Project-URL: Issues, https://github.com/Abhinavexists/dwarp/issues
+Keywords: terminal,ai,shell,assistant,cli,gemini
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: prompt-toolkit==3.0.51
+Requires-Dist: rich==14.1.0
+Requires-Dist: pydantic==2.11.7
+Requires-Dist: python-dotenv==1.1.1
+Requires-Dist: google-genai==1.31.0
+
+# Dwarp
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)](https://github.com/your-username/ai-enabled-terminal)
+
+Terminal assistant built as an open source minimal alternative to Warp.
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12 or higher
+- Linux operating system (Ubuntu, Arch, Fedora, CentOS, openSUSE, Debian supported) (Windows and MacOS will be supproted later on)
+- Google Gemini API key ([Get one here](https://aistudio.google.com/app/apikey))
+
+### Installation
+
+#### Option 1: Binary Release (Recommended)
+
+1. Download the latest release from [Releases](https://github.com/Abhinavexists/dwarp/releases)
+2. Extract and install:
+
+   ```bash
+   tar -xzf dwarp-linux.tar.gz
+   cd dwarp-linux
+   sudo ./install.sh
+   ```
+
+3. Launch the terminal:
+
+   ```bash
+   dwarp
+   ```
+
+4. Enter your Gemini API key when prompted
+
+#### Option 2: From Source
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/Abhinavexists/dwarp.git
+   cd dwarp
+   ```
+
+2. Create and activate virtual environment:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. Install dependencies:
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+4. Set up your API key:
+
+   ```bash
+   export GEMINI_API_KEY="your-api-key-here"
+   ```
+
+5. Run the application:
+
+   ```bash
+   python -m terminal.cli
+   ```
+
+## Usage Examples
+
+```bash
+# Natural language commands
+> install docker
+Command: sudo pacman -S docker
+Explanation: Installs Docker using the system package manager
+
+> find all python files in current directory
+Command: find . -name "*.py" -type f
+Explanation: Searches for all Python files in the current directory and subdirectories
+
+> compress folder into zip
+Command: zip -r archive.zip folder_name
+Explanation: Creates a ZIP archive of the specified folder
+
+> show disk usage sorted by size
+Command: du -sh * | sort -hr
+Explanation: Shows disk usage of all items in current directory, sorted by size
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## Pending stuff
+
+- [ ] Support for Windows and macOS
+- [ ] Custom command templates and aliases
+- [ ] Plugin system for extending functionality
+- [ ] Command explanation and learning mode
+- [ ] Integration with popular development tools
+- [ ] Multi-language support
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

dwarp-0.1.7/dwarp.egg-info/SOURCES.txt

@@ -0,0 +1,30 @@
+README.md
+pyproject.toml
+dwarp.egg-info/PKG-INFO
+dwarp.egg-info/SOURCES.txt
+dwarp.egg-info/dependency_links.txt
+dwarp.egg-info/entry_points.txt
+dwarp.egg-info/not-zip-safe
+dwarp.egg-info/requires.txt
+dwarp.egg-info/top_level.txt
+terminal/__init__.py
+terminal/cli.py
+terminal/agents/__init__.py
+terminal/agents/code_agent.py
+terminal/agents/general_agent.py
+terminal/agents/shell_agent.py
+terminal/api/__init__.py
+terminal/api/gemini.py
+terminal/commands/__init__.py
+terminal/commands/commands.py
+terminal/commands/os_info.py
+terminal/core/__init__.py
+terminal/core/agent.py
+terminal/core/executor.py
+terminal/core/router.py
+terminal/safety/__init__.py
+terminal/safety/safety.py
+terminal/utils/__init__.py
+terminal/utils/config.py
+terminal/utils/loading.py
+terminal/utils/parsers.py

dwarp-0.1.7/dwarp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dwarp-0.1.7/dwarp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dwarp = terminal.cli:main

dwarp-0.1.7/dwarp.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

dwarp-0.1.7/dwarp.egg-info/requires.txt

@@ -0,0 +1,5 @@
+prompt-toolkit==3.0.51
+rich==14.1.0
+pydantic==2.11.7
+python-dotenv==1.1.1
+google-genai==1.31.0

dwarp-0.1.7/dwarp.egg-info/top_level.txt

@@ -0,0 +1 @@
+terminal

dwarp-0.1.7/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dwarp"
+version = "0.1.7"
+description = "Terminal assistant built as an open source minimal alternative to Warp"
+authors = [{name = "Abhinav", email = "abhinavkumarsingh2023@gmail.com"}]
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Shells",
+    "Topic :: Utilities",
+]
+keywords = ["terminal", "ai", "shell", "assistant", "cli", "gemini"]
+dependencies = [
+    "prompt-toolkit==3.0.51",
+    "rich==14.1.0", 
+    "pydantic==2.11.7",
+    "python-dotenv==1.1.1",
+    "google-genai==1.31.0"
+]
+
+[project.scripts]
+dwarp = "terminal.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/Abhinavexists/dwarp"
+Repository = "https://github.com/Abhinavexists/dwarp.git"
+Issues = "https://github.com/Abhinavexists/dwarp/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["terminal*"]
+exclude = ["release*", "scripts*", "ai-terminal-linux*"]
+
+[tool.setuptools.package-data]
+terminal = ["*.py"]
+
+[tool.setuptools]
+zip-safe = false
+

dwarp-0.1.7/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dwarp-0.1.7/terminal/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.6"

dwarp-0.1.7/terminal/agents/code_agent.py

@@ -0,0 +1,83 @@
+from terminal.api import client, generate_config
+from terminal.core.executor import GeneralResponse, ResponseType
+from terminal.utils.parsers import parse_json, parse_response_parts, handle_function_call
+from terminal.utils.config import config
+
+def prompt_code():
+    return """You are a specialized coding assistant. Your job is to help users with code generation, programming questions, and technical implementations.
+
+IMPORTANT: Keep your response concise and within token limits. Focus on the most essential code and explanations.
+
+Output a JSON object with the following structure:
+
+{{
+    "content": "<your response with code examples and explanations>",
+    "response_type": "code_generation",
+    "action_required": false,
+    "suggested_command": null
+}}
+
+Instructions:
+- Provide clear, well-commented code examples
+- Keep explanations brief but informative
+- Include essential best practices only
+- If the code can be executed as a script, set action_required to true and provide suggested_command
+- Use appropriate programming languages based on the request
+- Include basic error handling where relevant
+- If the response is getting long, prioritize the core code over extensive explanations
+
+CRITICAL: Your response must be ONLY the JSON object, with no extra text, markdown formatting, or code blocks outside the JSON."""
+
+
+def process_code_request(user_input: str, context: str = "") -> GeneralResponse:
+    prompt = prompt_code()
+    if context:
+        prompt += f"\n\nAdditional Context: {context}"
+    
+    model_config = config.get_model_config()
+    response = client.models.generate_content(
+        contents=f"{prompt}\n\nUser request: {user_input}",
+        model=model_config["model"],
+        config=generate_config,
+    )
+    
+    if response.candidates and hasattr(response.candidates[0], "content") and response.candidates[0].content and hasattr(response.candidates[0].content, "parts") and response.candidates[0].content.parts:
+        for part in response.candidates[0].content.parts:
+            func_response = handle_function_call(part, ResponseType.CODE_GENERATION)
+            if func_response:
+                return GeneralResponse(**func_response)
+        
+        data = parse_response_parts(response.candidates[0].content.parts)
+        if data and "content" in data:
+            return GeneralResponse(**data)
+        
+        for part in response.candidates[0].content.parts:
+            if hasattr(part, "text") and part.text:
+                data = parse_json(part.text)
+                if data and "content" in data:
+                    return GeneralResponse(**data)
+                
+                raw_text = part.text.strip()
+                if raw_text and len(raw_text) > 10:  
+                    cleaned_text = raw_text
+                    if cleaned_text.startswith('```'):
+                        lines = cleaned_text.split('\n')
+                        if lines[0].startswith('```'):
+                            lines = lines[1:]
+                        if lines and lines[-1].strip() == '```':
+                            lines = lines[:-1]
+                        cleaned_text = '\n'.join(lines)
+                    
+                    return GeneralResponse(
+                        content=cleaned_text,
+                        response_type=ResponseType.CODE_GENERATION,
+                        action_required=False,
+                        suggested_command=None
+                    )
+
+    return GeneralResponse(
+        content=f"I apologize, but I encountered an issue generating a proper response for your request: '{user_input}'. The response may have been truncated due to length limits. Please try rephrasing your request or breaking it into smaller parts.",
+        response_type=ResponseType.CODE_GENERATION,
+        action_required=False,
+        suggested_command=None
+    )

dwarp-0.1.7/terminal/agents/general_agent.py

@@ -0,0 +1,69 @@
+from terminal.api import client, generate_config
+from terminal.core.executor import GeneralResponse
+from terminal.utils.parsers import parse_json, parse_response_parts
+from terminal.utils.config import config
+
+def prompt_general():
+    return """You are a helpful AI assistant specializing in general knowledge, explanations, and informational responses.
+
+IMPORTANT: Keep your response concise and within token limits. Focus on the most essential information.
+
+Output a JSON object with the following structure:
+
+{{
+    "content": "<your helpful response>",
+    "response_type": "general_query",
+    "action_required": false,
+    "suggested_command": null
+}}
+
+Instructions:
+- Provide clear, accurate, and concise information
+- Use examples and analogies to make complex topics understandable
+- If the user asks about something that could be done with a shell command, set action_required to true and provide suggested_command
+- Be conversational but informative
+- Keep responses focused and to the point
+- If the response is getting long, prioritize the most important information
+
+CRITICAL: Your response must be ONLY the JSON object, with no extra text, markdown formatting, or code blocks outside the JSON."""
+
+
+
+def process_general_request(user_input: str, context: str = "") -> GeneralResponse:
+    prompt = prompt_general()
+    if context:
+        prompt += f"\n\nAdditional Context: {context}"
+    
+    model_config = config.get_model_config()
+    response = client.models.generate_content(
+        contents=f"{prompt}\n\nUser request: {user_input}",
+        model=model_config["model"],
+        config=generate_config,
+    )
+    
+    if response.candidates and hasattr(response.candidates[0], "content") and response.candidates[0].content and hasattr(response.candidates[0].content, "parts") and response.candidates[0].content.parts:
+        data = parse_response_parts(response.candidates[0].content.parts)
+        if data and "content" in data:
+            return GeneralResponse(**data)
+        
+        for part in response.candidates[0].content.parts:
+            if hasattr(part, "text") and part.text:
+                data = parse_json(part.text)
+                if data and "content" in data:
+                    return GeneralResponse(**data)
+                
+                raw_text = part.text.strip()
+                if raw_text and len(raw_text) > 10:  
+                    return GeneralResponse(
+                        content=raw_text,
+                        response_type="general_query",
+                        action_required=False,
+                        suggested_command=None
+                    )
+
+    return GeneralResponse(
+        content=f"I apologize, but I encountered an issue generating a proper response for your request: '{user_input}'. Please try rephrasing your question or breaking it into smaller parts.",
+        response_type="general_query",
+        action_required=False,
+        suggested_command=None
+    )