Getting started¶
This page takes you from the AWS Marketplace listing to your first Open Interpreter task: subscribe, launch, connect, check the installation and run it with your own model provider. It takes about ten minutes.
You need: an AWS account with permission to subscribe to AWS Marketplace products and launch EC2 instances, and an API key for a model provider.
1. Subscribe¶
Open the Open Interpreter listing, review the pricing and terms, and subscribe.
2. Launch the instance¶
Launch from the listing with these settings:
- Instance type:
t3.medium. - Storage: at least 16 GiB, encrypted gp3.
- Metadata: IMDSv2.
- Security group: no inbound rules are needed. Allow outbound HTTPS.
- IAM instance profile: attach a role with the AWS managed policy
AmazonSSMManagedInstanceCoreso you can connect with Session Manager. Open Interpreter itself needs no AWS permissions.
3. Connect¶
Connect with Session Manager, from the EC2 console (Connect > Session Manager) or with the AWS CLI:
Wait for first boot to finish:
4. Run the walkthrough¶
The walkthrough checks that first boot succeeded, prints the installed
version, checks that the profile has auto-run off, telemetry disabled and no
API key, runs a small Python calculation locally, confirms the interpreter
command refuses -y, starts the interactive prompt once in offline mode, and
then runs the self-test. No model is called.
Each step prints STEP, COMMAND and RESULT lines, and the script ends
with SUSHI_CUSTOMER_DEMO_PASSED.
5. Set your provider key¶
Switch to the ubuntu user:
The profile uses the model gpt-4o by default. For OpenAI, set your key in
this shell only. With read -s, the key does not appear on screen or in your
shell history:
For another provider, change the model in the profile and export that provider's key instead. See Choose a model.
Keep your key out of the profile
Do not write api_key: into the profile. The image treats a key in that
file as a mistake: the first-boot service fails on the next boot and the
walkthrough refuses to run. Use an environment variable instead.
6. Run your first task¶
Go to the workspace and start Open Interpreter:
Describe what you want, for example "create a CSV with the numbers 1 to 10 and their squares, then print the sum of the squares". Open Interpreter explains its plan and shows the code it wants to run. Read it, then approve or refuse.
To leave, press Ctrl+D. Open Interpreter may ask whether you want to send feedback; answer no to share nothing.
Next steps¶
Choose a model, use an OpenAI-compatible endpoint and change the defaults in Configuration.
Last updated October 13, 2026 · Suggest an improvement