You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 4-6.RSVP β†’
Socket
Book a DemoInstallSign in
Socket

flamethrower

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

flamethrower

The ultimate debugging experience 🦠πŸ”₯

0.2.32
pipPyPI
Maintainers
1

πŸ”₯ flamethrower

No bugs can survive the test of fire; not even the ones you wrote into your codebase πŸͺ².

GitHub Repo PyPI Code Size Discord License Twitter

What is this?

πŸ”₯ flamethrower is an open source, multi-agent, context-intelligent, debugger that utilizes AI superpowers to automate the painful task of debugging. Think a combination of GitHub Copilot's context-awareness in KillianLucas' Open Interpreter packed into a beautiful shell that works out of the box with any existing repo.

Automate: [ Write Code β†’ Run Action β†’ Check Logs β†’ Repeat ] πŸš€πŸš€

Main Differentiators

  • πŸ”₯ Automate the most painful part of writing code: print statements & error logs
  • ☘️ Specialized context agent for operating within existing repo
  • πŸ€– Debugging agent optimized to iteratively brute-force locate and fix bugs
  • πŸ“¦ Out of the box support for any unix machine (no VS Code or VS Code alternatives)
  • 🎨 Seamless integration into any existing repo; just type flamethrower

Demo

https://github.com/scottsus/flamethrower/assets/88414565/e3c979c0-40ff-4976-aa30-2503a2827742

Quick Start

Quick Start

Install πŸ”₯ flamethrower

pip install flamethrower

Or, if you have an existing version and are looking to upgrade to the latest version

pip install --upgrade flamethrower

Terminal

Navigate to your current workspace, and simply run flamethrower, or ft for the pros.

cd ./unbelievably/complicated/workspace
flamethrower

Example Usage

Use lowercase letters for commands you run in the shell, like python main.py or node server.ts

πŸ”₯ flamethrower: Debugging on Autopilot

Instructions:
- ⌨️  Regular shell        Use commands like ls, cd, python hello.py
- πŸ€– LLM assistance       Start command with a Capital letter, try Who are you?
- πŸ“š Context              Intelligent context-awareness from command, files, and stdout logs
- πŸͺ΅ Terminal logs        All conversation & code output inside flamethrower is logged

...

$ python main.py -> SOME_ERROR
$ Wtf???? # Literally type this in the terminal

An implementation run is initiated with a natural language query that begins with an uppercase letter.

Features

πŸ’€ AFK Debugging

If you say 'Yes', πŸ”₯ flamethrower will debug in the background while you focus on other tasks at hand. It acts similarly to any other human engineer: adding print statements to find the root cause of the issue (which, as we know is the most annoying part). We find this pattern strikingly effective, and is where we believe LAMs have the strongest use case.

If it looks like πŸ”₯ flamethrower is obviously headed in the direction of doom, simply press CTRL+C and give it more suggestions or context.

AFK

πŸŽ™οΈ Conversation History

As long as any shell command or natural language query happens within the context of πŸ”₯ flamethrower, then it is by default captured in the conversation history. That means you can:

  • ask about an error that just happened, or happened 2 dialogues ago
  • follow up on a previous response provided by πŸ”₯ flamethrower

πŸ” Prompt Transparency

Prompts sent to LLM are transparent and easy to observe. All πŸ”₯ flamethrower metadata are neatly kept in a .flamethrower subdirectory, including prompts, conversations, logs, directory info, summaries, and other metadata.

Transparency

πŸ„β€β™€οΈ Real Time File Tracking

Everytime you send a query, the latest version of your files are sent over, meaning πŸ”₯ flamethrower understands that you changed your files, and are ready to process those changes.

Context

Motivation for πŸ”₯ flamethrower

πŸ‘©β€βœˆοΈ GitHub Copilot

Closed source GitHub Copilot draws context very effectively, and Quick Fix is a neat feature that explains error from stdout logs if the last command returned a non-zero return code.

πŸ€– Open Interpreter

The Open Interpreter, an open-source gem, specializes in crafting new code from the ground up. It's a favorite among data scientists and those needing sophisticated chart plotting, thanks to its iterative approach to achieving desired results.

πŸ”¬ Research

πŸ”₯ flamethrower combines the agency afforded by Large Action Models (LAM) with the workspace awareness of Copilot, allowing it to take context-specific suggestions and continue iteration until a successful outcome. πŸ”₯ flamethrower is workspace-first, and aims to serve software engineers in complex tasks that need a lot of context management.

πŸ₯‚ Contributing

πŸ”₯ flamethrower is everyone's debugger. Fork it for your own use case, and, one PR at a time we can make the world a more bug-free place ✨ just ping me at scottsus@usc.edu and I'll help you get started.

πŸ›« Project Roadmap

  • πŸ§ͺ Better testing
  • πŸ”­ Telemetry and the ability to opt in/out
  • πŸ₯½ LLM Vision to debug visual elements
  • πŸ¦™ Running CodeLlama locally
  • πŸ€– Other models besides OpenAI
  • 🦾 Default model finetuned on telemetry data
  • πŸŽ—οΈ VS Code integration
  • πŸ’» Browser interface

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts