HomeVideos

Agent Canvas Windows Docker Install Guide + First AI Agent Chat

Now Playing

Agent Canvas Windows Docker Install Guide + First AI Agent Chat

Transcript

218 segments

0:00

Agent Canvas is the latest way to get

0:02

started with Open Hands. Learn how to

0:04

use Docker to install on Windows and get

0:07

automations on GitHub and Slack.

0:10

Windows installation with a Docker

0:12

sandbox. You'll need Docker installed.

0:14

The Docker command for Windows is

0:16

different than the one [music] for Mac.

0:18

You'll need to check the Agent Canvas

0:20

GitHub Readme for the latest Docker

0:22

image. This is just a sample of what you

0:25

will run in your terminal.

0:27

Run the command to pull the image.

0:30

Then set your project path variable and

0:33

state path variable. Your project path

0:35

is the directory containing the files

0:37

you want your agent to have access to.

0:40

After that, run the Docker command.

0:43

>> [music]

0:43

>> Once you see that all services have

0:45

started, you're ready to go. Windows

0:48

install from source code. You'll need

0:51

Node, NPM, and UV installed. [music]

0:54

Please note that if you run the agent

0:56

server directly on your machine without

0:58

a sandbox, the agent will have full

1:00

access to your file system. These are

1:03

the commands that you'll execute in your

1:04

terminal. [music]

1:05

First, you'll need to clone the GitHub

1:07

repo.

1:09

Make sure to clone it in the directory

1:10

of your choice.

1:12

Once cloned, change into that directory.

1:17

Then you'll run NPM install.

1:20

Once installation is completed, run NPM

1:24

run dev.

1:27

When you see the localhost at the end,

1:30

you know that you're ready to get

1:31

started. Getting started, setting up

1:33

Agent Canvas and starting your first

1:36

chat. Navigate to localhost:8000.

1:39

[music]

1:41

You'll then go ahead and go through the

1:43

prompt choosing your agent. I'm going to

1:45

choose Open Hands.

1:47

You'll check your back end. This time it

1:49

will be local. Just click next.

1:52

Then you'll pick your LLM provider. In

1:55

this case, we'll use Anthropic, with the

1:58

Claude Opus 4.7. I'm going to input my

2:01

API key and click next.

2:04

From here, you can see our proven

2:07

workflows that you can try out with

2:09

Linear, Slack, Notion,

2:12

or you can enter your own prompt. We're

2:14

going to create a basic webpage

2:16

explaining what Open Hands can do. We're

2:19

going to click send, and that will open

2:20

up a new conversation.

2:23

The agent is going to start working on

2:25

the prompt given, in this case creating

2:27

a webpage. It will reply back in the

2:29

chat, and you can preview the webpage on

2:33

the right-hand side.

2:35

Getting started, [music]

2:36

adding Open Hands Cloud backend. Let's

2:39

go ahead and hover down to the local

2:42

area and click add backend.

2:45

We're then going to log in to Open Hands

2:48

Cloud. You'll see a new tab pop open

2:52

with some letters. That's the name of

2:54

this connection. You don't need to save

2:56

that. We're going to click authorize,

2:59

and then we'll return back to our agent

3:02

canvas. Then you'll be able to see that

3:06

we are now connected to Open Hands

3:08

Cloud. Create an LLM profile.

3:12

First, you'll want to navigate to your

3:13

settings and click [music] LLM.

3:17

From there, you'll click add LLM

3:19

profile. You can give that profile a

3:23

nickname. [music]

3:24

In this case, we are going to call it

3:26

MiniMax.

3:28

From there, you'll pick an LLM provider.

3:30

I'm going to pick Open Hands. I'm going

3:33

to pick the model MiniMax M.3, and I'm

3:36

going to put my API key in and click

3:41

save.

3:43

Once you've saved, now you have a couple

3:45

of different LLM profiles, and when you

3:47

create a new chat, you can pick which

3:50

profile you want to start with.

3:52

Creating an automation from scratch.

3:55

You can create an automation just by

3:57

starting a new chat. [music] In this

3:59

case, I'm going to create a new

4:00

automation where every day at 10:00 a.m.

4:05

Eastern, I'm going to have all my GitHub

4:08

notifications summarized and presented

4:11

to me in a chat.

4:14

From there, you can use any LLM model

4:18

that you want. I'm using GPT. If it's a

4:21

simple request, you can also use

4:23

something like MiniMax.

4:25

And then [music] the agent will go ahead

4:26

and get started on that task. Once it's

4:29

done, I'm going to return to the

4:32

automate tab, and I'm going to go ahead

4:34

and trigger it to run now, only for

4:36

demonstration purposes.

4:39

Then a chat will get kicked off. We're

4:40

going to open it to follow along, and

4:42

once it's done, it'll return that

4:44

summary of my GitHub notifications. In

4:47

the future, you could even set it up

4:50

with Slack so that it would send you a

4:51

message. Adding an agent canvas [music]

4:54

to your Slack server. You'll want to

4:56

navigate to api.slack.com/apps. You'll

5:01

want to click create an app,

5:04

and then [music] from scratch. You'll

5:06

then need to give this app a name.

5:08

Whatever you want is fine. And then

5:10

you'll need to pick a workspace. You'll

5:13

need to be admin of that workspace in

5:16

order to create and add an application.

5:19

Then click create app.

5:21

It'll have you return back to this page.

5:23

You'll want to scroll down and go to

5:25

OAuth and permissions.

5:28

Then you'll need to scroll down,

5:31

and you're going to want to add an OAuth

5:33

scope.

5:35

You'll see here that these are the

5:39

scopes that you need to add for this to

5:42

work.

5:44

Once you have all of them, scroll up to

5:46

install to dummy hands or whatever your

5:49

workspace [music] is called and click

5:51

allow. Afterwards, you'll scroll down

5:55

>> [music]

5:55

>> and there will be a bot user OAuth

5:59

token. Please [music] save that for

6:01

later.

6:03

Return to your workspace and click the

6:05

person icon.

6:07

From there, you'll want to go to the

6:09

integrations tab

6:11

and you're going to click add an app.

6:15

Once the new page opens up, you're going

6:18

to click add for the app, which we named

6:22

agent hands. You'll want to return back

6:24

to agent canvas and click automate in

6:27

the left hand. You'll then click Slack

6:30

channel monitor. You're going to put in

6:32

your team workspace ID, which you can

6:35

find in your URL,

6:37

and you'll also need to add that OAuth

6:39

bot token we saved earlier.

6:42

Once you click install, it'll open up a

6:44

new chat with a prompt. If you'd like,

6:47

you can go ahead and change the default

6:49

name

6:50

and then submit it to start the chat.

7:00

The agent is going to come back and ask

7:02

you a few questions like what channel,

7:05

in this case we want general, and also

7:09

what name to monitor for, and we are

7:11

going to use Joe-bot.

7:20

is done, you'll see something similar to

7:23

this be returned in your chat.

7:25

You can then navigate back to automate

7:28

and click [music] on that Slack channel

7:29

monitor to see that it is active.

7:33

Now, we'll return back to our workspace

7:36

>> [music]

7:36

>> and go ahead and send a message for our

7:39

bot.

7:43

Once the bot has seen this, it'll react

7:46

with some eyes and start a thread.

7:49

You can either go to the localhost URL

7:52

or wait for the agent to reply back with

7:55

your answer in Slack. Adding GitHub to

7:58

your agent canvas. First, navigate to

8:00

the automate tab on the left-hand side,

8:03

and then go ahead and pick a GitHub

8:06

workflow that you want to implement.

8:07

[music]

8:09

I'm going to pick the GitHub code

8:11

review, and I'm going to input my

8:14

personal access token,

8:16

and click install.

8:19

A new chat is going to open with the

8:21

skill, and I'm going to enter,

8:24

and then I will need to answer a few

8:25

questions, like [music] how often do I

8:29

want this automation to poll? I'm going

8:31

to pick every 5 minutes. I'm also going

8:34

[music] to have the agent comment on PRs

8:37

that are ready for review, but not

8:39

drafted,

8:41

and also put the agent's review as a

8:45

comment to that PR. And then I'm going

8:48

to pick [music] a repository for this

8:50

automation to monitor.

8:53

Now that the automation is done, just

8:55

for demonstration, I'm going to go ahead

8:57

and go back to the automate tab, and I'm

8:59

going to go ahead and click run now so

9:02

that I can get a review for my PR.

9:05

Once the job is done, I can go to

9:07

GitHub, and I can check out the comment

9:09

that was left.

9:11

Join our Slack if you have any questions

9:13

or comments. Thanks so much for

9:14

watching.

Interactive Summary

This video provides a comprehensive guide on getting started with Agent Canvas and Open Hands. It covers installation methods via Docker and source code, connecting to Open Hands Cloud, creating custom LLM profiles, and configuring automations for platforms like GitHub and Slack.

Suggested questions

4 ready-made prompts