Skip to content

An AI Agent IaC tool that aims to make developing and deploying AI Agents easier.

License

Notifications You must be signed in to change notification settings

willwoodward/woodwork-engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyPI - Version PyPI - Python Version PyPI - Installs License GitHub Stars

woodwork-engine

Welcome to woodwork-engine, an AI Agent IaC tool that aims to make developing and deploying AI Agents easier.

Through defining components in a configuration language, an LLM will decompose the task into actionable steps, which can be executed using the supplied tools. We use latest research to inform design decisions, and we implement this as most of the setup is copy/paste across projects. Through only focussing on the necessary components of a system, this package should make designing custom, vertical agents much easier.

Table of Contents

Features

  • A custom config language, woodwork (.ww files), allowing agent components to be declared
  • Integrations and communication between components are handled
  • Additional customisation or extension can be provided by implementing some of our interfaces

Screenshot 2025-01-01 160031

A roadmap is provided with details on future features.

Installation

  1. Run pip install woodwork-engine: This gives access to the woodwork CLI tool, along with the ability to parse and deploy AI Agent components from .ww files
  2. Install the Woodwork extension on VSCode if relevant: This provides syntax highlighting and intellisense for code in .ww files

Usage

  1. Create a main.ww file and write some code: This file is where component declarations are read from. For some inspiration, consult the examples
  2. Run woodwork init: This installs the necessary dependencies to run your components
  3. Run woodwork: This activates the components

Examples

For some examples, consult the examples folder. ENV variables are denotes by a '$', place a .env file in the same directory as the main.ww file and populate it with the necessary variables.

Contributing

To view the contributing guide for woodwork, the CONTRIBUTING.md file in the meta repository contains more information. We would love your help! Additionally, if you prefer working on other projects aligned with language servers or web development, woodwork-language and woodwork-website could be worth taking a look at.

License

woodwork-engine uses a GPL license, which can be read in full here.