locally796 0.1.0__tar.gz

locally796-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Prathmesh Ravindra Salunkhe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

locally796-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: locally796
+Version: 0.1.0
+Summary: AI-powered CLI tool to setup GitHub repositories locally
+Author-email: Prathmesh Salunkhe <salunkheprathmesh0@gmail.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: gitpython
+Requires-Dist: langchain
+Dynamic: license-file
+
+# Locally796
+
+**Locally796** is an AI-powered CLI tool that automatically clones any GitHub repository and sets it up on your local machine — no manual configuration needed. Powered by a LangChain agent, it detects the project stack, installs dependencies, configures environment variables, and runs the project for you.
+
+---
+
+## Features
+
+- 🤖 **AI-Driven Setup** — A LangChain agent acts as a senior DevOps engineer, analysing the repository, running the right install commands, and resolving errors automatically.
+- 🔍 **Stack Detection** — Automatically identifies the project stack (Node.js, Python, Go, etc.) and applies the appropriate setup steps.
+- ⚙️ **Dependency Installation** — Runs `npm install`, `pip install -r requirements.txt`, `go mod tidy`, and similar commands as needed.
+- 🌿 **Environment Configuration** — Detects `.env.example` files and sets up environment variables for you.
+- 🚀 **Project Launch** — Starts the project after setup and confirms it is running.
+- 📦 **pip Package** — Distributed as a Python package, so you can install and use it anywhere with a single command.
+
+---
+
+## Requirements
+
+- Python 3.11 or higher
+- A [Groq](https://console.groq.com/) API key to power the AI agent.
+
+---
+
+## Installation
+
+You can install `locally796` globally using `pip`:
+
+```bash
+pip install locally796
+```
+
+*(Alternatively, to install from source: clone this repo and run `pip install -e .` inside the folder.)*
+
+### Setup Your API Key
+
+Before using `locally796` for the first time, you need to configure your Groq API key. The agent defaults to `llama-3.3-70b-versatile`, which is available for any standard Groq account.
+
+```bash
+locally796 set-key <YOUR_GROQ_API_KEY>
+```
+
+This securely saves your key in a global config file (`~/.locally796/.env`), meaning you can run the tool from anywhere on your system without having to set up `.env` files manually.
+
+---
+
+## Usage
+
+```bash
+locally796 [GITHUB_REPO_URL] --path [CLONING_PATH]
+```
+
+### Arguments
+
+| Argument | Description |
+|---|---|
+| `GITHUB_REPO_URL` | The full URL of the GitHub repository to clone and set up |
+| `--path` / `-p` | *(Optional)* Local directory path where the repo will be cloned. Defaults to a folder named after the repo in the current directory |
+
+### Example
+
+```bash
+locally796 https://github.com/prathmesh796/pubsubs --path ./test-clone
+```
+
+This single command will autonomously:
+1. Clone the repository into `./test-clone`
+2. Detect the technology stack (e.g. Node.js, Python)
+3. Launch the LangChain Agent to investigate the codebase.
+4. Install all required dependencies (`npm install`, `pip install`, etc.)
+5. Configure environment variables (if `.env.example` is present)
+6. Start the local development server (e.g., `npm run dev`)
+7. Automatically detect and fix any deployment errors if the server fails to start!
+
+---
+
+## How It Works
+
+1. **Clone** — The repo is cloned to the specified (or auto-generated) local path using GitPython.
+2. **Detect** — The stack detector inspects the repository files to identify languages and frameworks.
+3. **Agent Setup** — A LangChain agent equipped with shell, file-read, and file-write tools executes the full setup autonomously. If a command fails or crashes, the agent reads the error output, figures out the fix, and retries until success!
+4. **Done** — The agent reports `SETUP_COMPLETE` and leaves the server running for you.
+
+---
+
+## License
+
+MIT
+   

locally796-0.1.0/README.md

@@ -0,0 +1,89 @@
+# Locally796
+
+**Locally796** is an AI-powered CLI tool that automatically clones any GitHub repository and sets it up on your local machine — no manual configuration needed. Powered by a LangChain agent, it detects the project stack, installs dependencies, configures environment variables, and runs the project for you.
+
+---
+
+## Features
+
+- 🤖 **AI-Driven Setup** — A LangChain agent acts as a senior DevOps engineer, analysing the repository, running the right install commands, and resolving errors automatically.
+- 🔍 **Stack Detection** — Automatically identifies the project stack (Node.js, Python, Go, etc.) and applies the appropriate setup steps.
+- ⚙️ **Dependency Installation** — Runs `npm install`, `pip install -r requirements.txt`, `go mod tidy`, and similar commands as needed.
+- 🌿 **Environment Configuration** — Detects `.env.example` files and sets up environment variables for you.
+- 🚀 **Project Launch** — Starts the project after setup and confirms it is running.
+- 📦 **pip Package** — Distributed as a Python package, so you can install and use it anywhere with a single command.
+
+---
+
+## Requirements
+
+- Python 3.11 or higher
+- A [Groq](https://console.groq.com/) API key to power the AI agent.
+
+---
+
+## Installation
+
+You can install `locally796` globally using `pip`:
+
+```bash
+pip install locally796
+```
+
+*(Alternatively, to install from source: clone this repo and run `pip install -e .` inside the folder.)*
+
+### Setup Your API Key
+
+Before using `locally796` for the first time, you need to configure your Groq API key. The agent defaults to `llama-3.3-70b-versatile`, which is available for any standard Groq account.
+
+```bash
+locally796 set-key <YOUR_GROQ_API_KEY>
+```
+
+This securely saves your key in a global config file (`~/.locally796/.env`), meaning you can run the tool from anywhere on your system without having to set up `.env` files manually.
+
+---
+
+## Usage
+
+```bash
+locally796 [GITHUB_REPO_URL] --path [CLONING_PATH]
+```
+
+### Arguments
+
+| Argument | Description |
+|---|---|
+| `GITHUB_REPO_URL` | The full URL of the GitHub repository to clone and set up |
+| `--path` / `-p` | *(Optional)* Local directory path where the repo will be cloned. Defaults to a folder named after the repo in the current directory |
+
+### Example
+
+```bash
+locally796 https://github.com/prathmesh796/pubsubs --path ./test-clone
+```
+
+This single command will autonomously:
+1. Clone the repository into `./test-clone`
+2. Detect the technology stack (e.g. Node.js, Python)
+3. Launch the LangChain Agent to investigate the codebase.
+4. Install all required dependencies (`npm install`, `pip install`, etc.)
+5. Configure environment variables (if `.env.example` is present)
+6. Start the local development server (e.g., `npm run dev`)
+7. Automatically detect and fix any deployment errors if the server fails to start!
+
+---
+
+## How It Works
+
+1. **Clone** — The repo is cloned to the specified (or auto-generated) local path using GitPython.
+2. **Detect** — The stack detector inspects the repository files to identify languages and frameworks.
+3. **Agent Setup** — A LangChain agent equipped with shell, file-read, and file-write tools executes the full setup autonomously. If a command fails or crashes, the agent reads the error output, figures out the fix, and retries until success!
+4. **Done** — The agent reports `SETUP_COMPLETE` and leaves the server running for you.
+
+---
+
+## License
+
+MIT
+   

locally796-0.1.0/app/cli/app.py

@@ -0,0 +1,59 @@
+import typer
+import os
+from typing import Optional
+from rich.console import Console
+
+from app.services.repo import clone_repo
+from app.services.detector import detect_stack
+from app.core.agent import run_setup_and_start
+from app.utils.logger import logger
+
+app = typer.Typer(help="Locally796 - AI powered CLI tool to clone and run any repo.", add_completion=False)
+console = Console()
+
+@app.command()
+def set_key(api_key: str = typer.Argument(..., help="Your Groq API Key")):
+    """Sets the global Groq API key for Locally796."""
+    home_dir = os.path.expanduser("~/.locally796")
+    os.makedirs(home_dir, exist_ok=True)
+    env_file = os.path.join(home_dir, ".env")
+    
+    with open(env_file, "w") as f:
+        f.write(f"GROQ_API_KEY={api_key}\n")
+    
+    console.print("[bold green]✅ API Key saved successfully![/bold green] You can now run `locally796` from anywhere.")
+
+@app.command()
+def clone_and_run(
+    repo_url: str = typer.Argument(..., help="The GitHub repository URL to process"),
+    path: Optional[str] = typer.Option(None, "--path", "-p", help="Destination path for cloning"),
+):
+    """
+    Clone a repository, detect stack, install dependencies, and run it.
+    """
+    console.print(f"[bold blue]Starting Locally796 for:[/bold blue] {repo_url}")
+    if path:
+        target_path = path
+    else:
+        # Predict the repo name from the url
+        base_name = repo_url.rstrip('/').split('/')[-1]
+        if base_name.endswith('.git'):
+            base_name = base_name[:-4]
+        target_path = os.path.join(os.getcwd(), base_name)
+    
+    console.print(f"[bold blue]Target path:[/bold blue] {target_path}")
+
+    # Step 1: Clone Repo
+    success = clone_repo(repo_url, target_path)
+    if not success:
+        console.print("[bold red]Aborting due to clone failure.[/bold red]")
+        raise typer.Exit(code=1)
+
+    # Step 2: Detect Stack
+    detected_stacks = detect_stack(target_path)
+
+    # Step 3: Run Setup Agent
+    run_setup_and_start(target_path, detected_stacks)
+    
+if __name__ == "__main__":
+    app()

locally796-0.1.0/app/config/env.py

@@ -0,0 +1,10 @@
+import platform
+
+os_name = platform.system()
+
+if os_name == "Windows":
+    print("Running on Windows")
+elif os_name == "Darwin":
+    print("Mac")
+else:
+    print("Linux")

locally796-0.1.0/app/config/settings.py

@@ -0,0 +1,14 @@
+import os
+from dotenv import load_dotenv
+
+home_env = os.path.expanduser("~/.locally796/.env")
+if os.path.exists(home_env):
+    load_dotenv(home_env)
+
+load_dotenv()
+
+class Settings:
+    GROQ_API_KEY = os.getenv("GROQ_API_KEY")
+    LOG_LEVEL = os.getenv("LOG_LEVEL", "INFO")
+
+settings = Settings()

locally796-0.1.0/app/core/agent.py

@@ -0,0 +1,58 @@
+from langchain_classic.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.tools import tool
+from langchain_core.prompts import ChatPromptTemplate
+from app.core.llm import get_llm
+from app.core.tools import run_shell_command, read_file, list_dir, write_file
+from app.utils.logger import logger, console
+
+AGENT_SYSTEM_PROMPT = """You are a senior DevOps engineer and setup assistant.
+Your task is to properly setup and run a software project.
+
+You have the following capabilities:
+1. Examine project files and directories to understand the structure.
+2. Formulate necessary setup commands (e.g. `npm install`, `pip install -r requirements.txt`, `go mod tidy`).
+3. Set up environment variables if a `.env.example` exists. 
+4. Execute run commands (e.g. `npm run dev`, `python app.py`) to verify it works.
+
+If a command fails, read its output, figure out the issue, fix it, and retry.
+NEVER execute obviously destructive commands (like `rm -rf /`).
+Always execute commands in the correct `cwd` which the user provides as context.
+Important: When running a dev server that blocks (like `npm run dev`), if it prints 'compiled successfully' or starts listening on a port, consider the step SUCCESSFUL. Our executor incorporates a 60-second timeout. If it prints a timeout error but indicates a server has started, consider the operation successful.
+
+When you have successfully set everything up and run the project, respond with "SETUP_COMPLETE" and explain what you did.
+
+CRITICAL TOOL USAGE INSTRUCTION:
+When calling a tool, ensure the tool name strictly matches the function name (e.g., 'list_dir'). DO NOT put JSON arguments or string blocks inside the tool name field itself! Provide arguments normally via the valid arguments object.
+"""
+
+def run_setup_and_start(target_path: str, detected_stacks: list):
+    try:
+        llm = get_llm()
+    except Exception as e:
+        console.print(f"[bold red]LLM Initialization Error:[/bold red] {e}")
+        return
+
+    tools = [run_shell_command, read_file, list_dir, write_file]
+
+    prompt = ChatPromptTemplate.from_messages([
+        ("system", AGENT_SYSTEM_PROMPT),
+        ("human", "Set up the project in the `{target_path}` directory.\nDetected stacks: {detected_stacks}.\nPlease execute the installation steps and then run the project. Use your tools sequentially to accomplish this."),
+        ("placeholder", "{agent_scratchpad}"),
+    ])
+
+    agent = create_tool_calling_agent(llm, tools, prompt)
+    agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True, handle_parsing_errors=True)
+
+    console.print(f"[bold blue]Initializing Setup Agent for:[/bold blue] {target_path}")
+    logger.info("Starting agent executor.")
+    
+    try:
+        response = agent_executor.invoke({
+            "target_path": target_path,
+            "detected_stacks": ", ".join(detected_stacks) if detected_stacks else "Unknown"
+        })
+        console.print("[bold green]Agent completed its process.[/bold green]")
+        logger.info(f"Agent response: {response.get('output', '')}")
+    except Exception as e:
+        console.print(f"[bold red]Agent encountered a fatal error:[/bold red] {e}")
+        logger.error(f"Agent execution failed: {e}")

locally796-0.1.0/app/core/llm.py

@@ -0,0 +1,12 @@
+from langchain_groq import ChatGroq
+from app.config.settings import settings
+
+def get_llm():
+    if not settings.GROQ_API_KEY:
+        raise ValueError("GROQ_API_KEY is not set. Please run 'locally796 set-key <YOUR_API_KEY>' to configure it globally.")
+    return ChatGroq(
+        model="llama-3.3-70b-versatile",
+        api_key=settings.GROQ_API_KEY,
+        temperature=0.2,
+        max_retries=2
+    )

locally796-0.1.0/app/core/tools.py

@@ -0,0 +1,49 @@
+import os
+from langchain.tools import tool
+from app.services.executor import execute_command
+
+@tool
+def run_shell_command(command: str, cwd: str) -> str:
+    """
+    Executes a shell command in the specified directory (cwd) and returns its output.
+    Useful for installing dependencies, running the app, or fixing environments.
+    """
+    res = execute_command(command, cwd)
+    output = f"Status: {res['status']}\nExit code: {res['return_code']}\n"
+    if res['stdout']:
+        output += f"STDOUT:\n{res['stdout']}\n"
+    if res['stderr']:
+        output += f"STDERR:\n{res['stderr']}\n"
+    return output
+
+@tool
+def read_file(file_path: str) -> str:
+    """Reads the contents of a file."""
+    if not os.path.exists(file_path):
+        return f"Error: File '{file_path}' does not exist."
+    try:
+        with open(file_path, "r", encoding="utf-8") as f:
+            return f.read()
+    except Exception as e:
+        return f"Error reading file '{file_path}': {str(e)}"
+
+@tool
+def list_dir(directory: str) -> str:
+    """Lists files and directories in the specified directory."""
+    if not os.path.exists(directory):
+        return f"Error: Directory '{directory}' does not exist."
+    try:
+        items = os.listdir(directory)
+        return "\n".join(items) if items else "Directory is empty."
+    except Exception as e:
+        return f"Error listing directory '{directory}': {str(e)}"
+
+@tool
+def write_file(file_path: str, content: str) -> str:
+    """Writes content to a file. Useful for creating .env files or fixing configs."""
+    try:
+        with open(file_path, "w", encoding="utf-8") as f:
+            f.write(content)
+        return f"File '{file_path}' written successfully."
+    except Exception as e:
+        return f"Error writing file '{file_path}': {str(e)}"

locally796-0.1.0/app/main.py

@@ -0,0 +1,5 @@
+import typer
+from app.cli.app import app
+
+if __name__ == "__main__":
+    app()

locally796-0.1.0/app/services/detector.py

@@ -0,0 +1,24 @@
+import os
+from typing import List
+from app.utils.constants import STACK_FILES
+from app.utils.logger import logger, console
+
+def detect_stack(target_path: str) -> List[str]:
+    detected = []
+    logger.info(f"Detecting stack in {target_path}...")
+    for filename, stack_name in STACK_FILES.items():
+        file_path = os.path.join(target_path, filename)
+        if os.path.exists(file_path):
+            detected.append(stack_name)
+    
+    # Deduplicate while preserving order if needed
+    detected = list(set(detected))
+    
+    if detected:
+        console.print(f"[bold green]✓ Detected Stack:[/bold green] {', '.join(detected)}")
+        logger.info(f"Detected stacks: {detected}")
+    else:
+        console.print("[yellow]⚠ Could not automatically detect a standard stack.[/yellow]")
+        logger.warning("No stack detected.")
+    
+    return detected

locally796-0.1.0/app/services/executor.py

@@ -0,0 +1,58 @@
+import subprocess
+import sys
+from typing import Dict, Any
+from app.utils.logger import logger, console
+
+def execute_command(command: str, cwd: str, timeout: int = 60) -> Dict[str, Any]:
+    """Execute a shell command and return its output. Includes a timeout for long-running processes."""
+    logger.info(f"Executing: `{command}` in {cwd} with timeout {timeout}s")
+    console.print(f"[dim]Running:[/dim] {command}")
+    
+    try:
+        process = subprocess.Popen(
+            command,
+            cwd=cwd,
+            shell=True,
+            text=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE
+        )
+        
+        try:
+            stdout, stderr = process.communicate(timeout=timeout)
+            return {
+                "command": command,
+                "return_code": process.returncode,
+                "stdout": stdout.strip() if stdout else "",
+                "stderr": stderr.strip() if stderr else "",
+                "status": "completed"
+            }
+        except subprocess.TimeoutExpired:
+            logger.warning(f"Execution timed out after {timeout} seconds.")
+            
+            if sys.platform == "win32":
+                subprocess.run(f"taskkill /F /T /PID {process.pid}", shell=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+            else:
+                process.kill()
+                
+            try:
+                stdout, stderr = process.communicate(timeout=2)
+            except subprocess.TimeoutExpired:
+                stdout, stderr = "Process is still running (Timeout reached). Likely a server started successfully.", ""
+                
+            return {
+                "command": command,
+                "return_code": 0,
+                "stdout": stdout.strip() if stdout else "Process is still running (Timeout reached). Likely a server started successfully.",
+                "stderr": stderr.strip() if stderr else "",
+                "status": "timeout"
+            }
+    except Exception as e:
+        logger.error(f"Execution failed: {e}")
+        return {
+            "command": command,
+            "return_code": -1,
+            "stdout": "",
+            "stderr": str(e),
+            "status": "error"
+        }

locally796-0.1.0/app/services/repo.py

@@ -0,0 +1,21 @@
+import os
+import git
+from app.utils.logger import logger, console
+
+def clone_repo(repo_url: str, target_path: str) -> bool:
+    try:
+        if os.path.exists(target_path) and os.path.isdir(target_path):
+            if os.listdir(target_path):
+                logger.info(f"Target directory {target_path} already exists and is not empty.")
+                console.print(f"[yellow]Skipping clone, directory not empty: {target_path}[/yellow]")
+                return True
+        logger.info(f"Cloning {repo_url} into {target_path}...")
+        with console.status(f"[bold green]Cloning {repo_url}...[/bold green]"):
+            git.Repo.clone_from(repo_url, target_path)
+        logger.info("Clone completed successfully.")
+        console.print("[bold green]✓ Repository cloned successfully.[/bold green]")
+        return True
+    except Exception as e:
+        logger.error(f"Failed to clone repository: {str(e)}")
+        console.print(f"[bold red]✗ Failed to clone repository: {str(e)}[/bold red]")
+        return False

locally796-0.1.0/app/utils/constants.py

@@ -0,0 +1,9 @@
+STACK_FILES = {
+    "package.json": "Node.js",
+    "requirements.txt": "Python",
+    "pyproject.toml": "Python",
+    "go.mod": "Go",
+    "Cargo.toml": "Rust",
+    "pom.xml": "Java",
+    "Dockerfile": "Docker"
+}

locally796-0.1.0/app/utils/logger.py

@@ -0,0 +1,16 @@
+import logging
+from rich.console import Console
+from rich.logging import RichHandler
+
+console = Console()
+
+def get_logger(name: str):
+    logging.basicConfig(
+        level="INFO",
+        format="%(message)s",
+        datefmt="[%X]",
+        handlers=[RichHandler(rich_tracebacks=True)]
+    )
+    return logging.getLogger(name)
+
+logger = get_logger("locally796")

locally796-0.1.0/locally796.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: locally796
+Version: 0.1.0
+Summary: AI-powered CLI tool to setup GitHub repositories locally
+Author-email: Prathmesh Salunkhe <salunkheprathmesh0@gmail.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: gitpython
+Requires-Dist: langchain
+Dynamic: license-file
+
+# Locally796
+
+**Locally796** is an AI-powered CLI tool that automatically clones any GitHub repository and sets it up on your local machine — no manual configuration needed. Powered by a LangChain agent, it detects the project stack, installs dependencies, configures environment variables, and runs the project for you.
+
+---
+
+## Features
+
+- 🤖 **AI-Driven Setup** — A LangChain agent acts as a senior DevOps engineer, analysing the repository, running the right install commands, and resolving errors automatically.
+- 🔍 **Stack Detection** — Automatically identifies the project stack (Node.js, Python, Go, etc.) and applies the appropriate setup steps.
+- ⚙️ **Dependency Installation** — Runs `npm install`, `pip install -r requirements.txt`, `go mod tidy`, and similar commands as needed.
+- 🌿 **Environment Configuration** — Detects `.env.example` files and sets up environment variables for you.
+- 🚀 **Project Launch** — Starts the project after setup and confirms it is running.
+- 📦 **pip Package** — Distributed as a Python package, so you can install and use it anywhere with a single command.
+
+---
+
+## Requirements
+
+- Python 3.11 or higher
+- A [Groq](https://console.groq.com/) API key to power the AI agent.
+
+---
+
+## Installation
+
+You can install `locally796` globally using `pip`:
+
+```bash
+pip install locally796
+```
+
+*(Alternatively, to install from source: clone this repo and run `pip install -e .` inside the folder.)*
+
+### Setup Your API Key
+
+Before using `locally796` for the first time, you need to configure your Groq API key. The agent defaults to `llama-3.3-70b-versatile`, which is available for any standard Groq account.
+
+```bash
+locally796 set-key <YOUR_GROQ_API_KEY>
+```
+
+This securely saves your key in a global config file (`~/.locally796/.env`), meaning you can run the tool from anywhere on your system without having to set up `.env` files manually.
+
+---
+
+## Usage
+
+```bash
+locally796 [GITHUB_REPO_URL] --path [CLONING_PATH]
+```
+
+### Arguments
+
+| Argument | Description |
+|---|---|
+| `GITHUB_REPO_URL` | The full URL of the GitHub repository to clone and set up |
+| `--path` / `-p` | *(Optional)* Local directory path where the repo will be cloned. Defaults to a folder named after the repo in the current directory |
+
+### Example
+
+```bash
+locally796 https://github.com/prathmesh796/pubsubs --path ./test-clone
+```
+
+This single command will autonomously:
+1. Clone the repository into `./test-clone`
+2. Detect the technology stack (e.g. Node.js, Python)
+3. Launch the LangChain Agent to investigate the codebase.
+4. Install all required dependencies (`npm install`, `pip install`, etc.)
+5. Configure environment variables (if `.env.example` is present)
+6. Start the local development server (e.g., `npm run dev`)
+7. Automatically detect and fix any deployment errors if the server fails to start!
+
+---
+
+## How It Works
+
+1. **Clone** — The repo is cloned to the specified (or auto-generated) local path using GitPython.
+2. **Detect** — The stack detector inspects the repository files to identify languages and frameworks.
+3. **Agent Setup** — A LangChain agent equipped with shell, file-read, and file-write tools executes the full setup autonomously. If a command fails or crashes, the agent reads the error output, figures out the fix, and retries until success!
+4. **Done** — The agent reports `SETUP_COMPLETE` and leaves the server running for you.
+
+---
+
+## License
+
+MIT
+   

locally796-0.1.0/locally796.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+README.md
+pyproject.toml
+app/__init__.py
+app/main.py
+app/cli/__init__.py
+app/cli/app.py
+app/config/__init__.py
+app/config/env.py
+app/config/settings.py
+app/core/__init__.py
+app/core/agent.py
+app/core/llm.py
+app/core/tools.py
+app/services/__init__.py
+app/services/detector.py
+app/services/executor.py
+app/services/repo.py
+app/utils/__init__.py
+app/utils/constants.py
+app/utils/logger.py
+locally796.egg-info/PKG-INFO
+locally796.egg-info/SOURCES.txt
+locally796.egg-info/dependency_links.txt
+locally796.egg-info/entry_points.txt
+locally796.egg-info/requires.txt
+locally796.egg-info/top_level.txt
+tests/test.py

locally796-0.1.0/locally796.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

locally796-0.1.0/locally796.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+locally796 = app.main:app

locally796-0.1.0/locally796.egg-info/requires.txt

@@ -0,0 +1,4 @@
+typer
+rich
+gitpython
+langchain

locally796-0.1.0/locally796.egg-info/top_level.txt

@@ -0,0 +1 @@
+app

locally796-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "locally796"
+version = "0.1.0"
+description = "AI-powered CLI tool to setup GitHub repositories locally"
+authors = [
+    { name="Prathmesh Salunkhe", email="salunkheprathmesh0@gmail.com" }
+]
+readme = "README.md"
+requires-python = ">=3.11"
+
+dependencies = [
+    "typer",
+    "rich",
+    "gitpython",
+    "langchain",
+]
+
+[project.scripts]
+locally796 = "app.main:app"
+
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["app*"]

locally796-0.1.0/setup.cfg

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

locally796-0.1.0/tests/test.py

@@ -0,0 +1,5 @@
+import langchain_core
+import langchain_community
+
+print("Langchain Core version:", langchain_core.__version__)
+print("Langchain Community version:", langchain_community.__version__)