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.
- 🤖 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.examplefiles 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.
- Python 3.11 or higher
- A Groq API key to power the AI agent.
You can install locally796 globally using pip:
pip install locally796(Alternatively, to install from source: clone this repo and run pip install -e . inside the folder.)
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.
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.
locally796 [GITHUB_REPO_URL] --path [CLONING_PATH]| 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 |
locally796 https://github.com/prathmesh796/pubsubs --path ./test-cloneThis single command will autonomously:
- Clone the repository into
./test-clone - Detect the technology stack (e.g. Node.js, Python)
- Launch the LangChain Agent to investigate the codebase.
- Install all required dependencies (
npm install,pip install, etc.) - Configure environment variables (if
.env.exampleis present) - Start the local development server (e.g.,
npm run dev) - Automatically detect and fix any deployment errors if the server fails to start!
- Clone — The repo is cloned to the specified (or auto-generated) local path using GitPython.
- Detect — The stack detector inspects the repository files to identify languages and frameworks.
- 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!
- Done — The agent reports
SETUP_COMPLETEand leaves the server running for you.
MIT