​​ApeWorX: The New Python Framework on the Block

Python developers love working with the smart contract framework Brownie. A successor to Brownie is in the making—creating a reimagination of the Python Web3 developer experience.

In this piece, I’ll be talking about ApeWorX, also known as “Ape”.

ApeWorX is a Python-based smart contract development and deployment framework known for its customizability and safe private key management.

Many of you know that I love Python, and upon entering the Web3 space I fell in love with the Brownie framework. Since I entered the space, it seems as if all the original Web3 frameworks have either been succeeded or another competitor has swooped in:

The Ethereum Python community is known for being one of the most collaborative and tight-knit groups out there. Many of the Vyper and Brownie contributors can be seen on the list of Ape contributors, including Doggie B, Banteg, and Skellet0r (and to a lesser extent, even myself!) 

Additionally, both Python enthusiasts and DeFi protocols like Curve have started using Ape as a framework for their contracts.

Today we are going to take a high-level “Web3 lickity-split” look at coming at ApeWorX from a Brownie user’s perspective. 

Web3 Lickity-Split Look

You can find a minimal ApeWorX & Vyper template in our ApeWorX-starter-kit with code examples to get you started. 

After installing ape with something like pipx install eth-ape or pip, you’ll have access to the ape command-line interface.

The quickest way to start a new project is to use ape init, which will give you a blank setup that will look as such:


├── ape-config.yaml

├── contracts

├── scripts

└── tests

Here’s what each folder contains:

  • Contracts: Where all your Vyper, Solidity, or other contracts will go.
  • Scripts: Where all your Python code will go.
  • Tests: Your Python tests. 
  • ape-config.yaml: The config file for your project. This is the ape equivalent of brownie-config.yaml or hardhat.config.js. 

In your scripts folder, you can make a script like:

def main():


To run any of your Python scripts in ape, run:

ape run scripts/my_script.py


Ape doesn’t have Vyper, Solidity, or really anything by default, and instead uses a system of plugins to make ApeWorX completely customizable to your specific smart contract needs. Two of the most popular plugins are those for Solidity and Alchemy, which allow you to compile Solidity contracts and easily deploy to Alchemy. 

ape plugins install solidity alchemy

Once you have this set up, you can write your Solidity contract in the contracts folder and compile. 

ape compile


Ape takes a specific approach to working with networks. Most frameworks, including Hardhat, Brownie, and Foundry, treat EVM chains in a similar fashion. ApeWorX is different. 

ApeWorX separates networks into ecosystems and chains. For example, the Ethereum ecosystem is separated into mainnet, ropsten, kovan, goerli, etc. If you want to work with something like Fantom, you can install the fantom network plugin:

ape plugins install fantom

Then you’ll see your new list of networks on the ape networks list:  


├── opera                                                                                                   

│   └── geth  (default)                                                                                     

├── testnet                                                                                                 

│   └── geth  (default)                                                                                     

└── local  (default)                                                                                        

   └── test  (default)

In cases where you don’t want to have to install a plugin for your network, you can use the ad-hoc method and just drop the RPC URL to the network you like. ape will assume as much as it can for sending transactions. 

ape run scripts/my_script.py --network https://my_rpc_url.com


One of the biggest differences across frameworks is how they deal with accounts. Most frameworks have you setup a .env file to store your private keys in. However, putting your private keys in a .env has been tripping up developers forever. You can do this in ape, but the default is much safer. 

Ape allows you to import private keys, then it will encrypt and store them on your computer. Whenever you want to work with that account or private key, you’ll need the password to decrypt it. This means no more accidentally pushing your keys up to GitHub!

ape accounts import my_key

It will then prompt you for your key and your password. In your Python scripts, you can then get your private key using the load function.

from ape import accounts


When you run this script, you’ll be prompted for your password. 

The Rest…

The rest of the framework works as you’d expect. You can write your tests using pytest, one of the most popular Python testing frameworks. You can enter the ape console to work with an interactive shell in a Python environment with your network of choice. 

It’s everything you’d want and expect from a framework. 

Ape is a new player in the framework space, and it’s a wonderful repo to contribute to. If you love Python and have an idea on how to improve ape, be sure to leave an issue, a pull request, or just drop them a star!

Happy Ape-ing!

The opinions expressed within this post are solely the author’s and do not reflect the opinions and beliefs of the Chainlink Foundation or Chainlink Labs.

Need Integration Support?
Talk to an expert
Get testnet tokens
Read the Docs
Technical documentation