/run-wild

Augment GPT-4 Environment Access

Primary LanguageRustMIT LicenseMIT

Run Wild

run-wild extends m1guelpf's browser-agent project by allowing gpt4 to alter it's goal. This is very dumb and probably ought not exist, but c'est la vie.

At it's core, run-wild bridges GPT-4 and a headless Chromium browser, automating actions as self-directed by it's goal. It takes the form of a Rust CLI, but also exports most of the internals as a library for others to use.

Installation

run-wild is built using Rust, so you'll need to install the Rust toolchain. You can do this by following the instructions at rustup.rs.

Once you have Rust installed, you can install run-wild by running:

cargo install run-wild

You should also place your OpenAI API key in the OPENAI_API_KEY environment variable. This key should have access to the gpt-4 model.

You can copy the contents of the example.env file to a .env file in the root of the project, and fill in the OPENAI_API_KEY variable. The .env file is ignored by git, so you don't have to worry about accidentally committing your API key. Note though, .env.example is not ignored, so you should not change that file.

Usage

Usage: run-wild [OPTIONS] <GOAL>

Options:
      --visual                Whether to show the browser window. Warning: this makes the agent more unreliable
  -v...                       Set the verbosity level, can be used multiple times
      --include-page-content  Whether to include text from the page in the prompt
  -h, --help                  Print help
  -V, --version               Print version

Acknowledgements

This project was inspired and builds on top of Nat Friedman's natbot experiment.

License

This project is licensed under the MIT license. See LICENSE for more details.