aboutsummaryrefslogtreecommitdiff
path: root/docs/content/usage.md
blob: 48b24a5c5d571eca7d612c5ef73e9f85e7e970cf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
# Usage

## Command Line Arguments
Running with `--help` lists all the possible command line arguments you can pass:

```shell
./run.sh --help     # on Linux / macOS

.\run.bat --help    # on Windows
```

!!! info
    For use with Docker, replace the script in the examples with
    `docker compose run --rm auto-gpt`:

    ```shell
    docker compose run --rm auto-gpt --help
    docker compose run --rm auto-gpt --ai-settings <filename>
    ```

!!! note
    Replace anything in angled brackets (<>) to a value you want to specify

Here are some common arguments you can use when running AutoGPT:

* Run AutoGPT with a different AI Settings file

```shell
./run.sh --ai-settings <filename>
```

* Run AutoGPT with a different Prompt Settings file

```shell
./run.sh --prompt-settings <filename>
```

* Specify a memory backend

```shell
./run.sh --use-memory  <memory-backend>
```

!!! note
    There are shorthands for some of these flags, for example `-m` for `--use-memory`.  
    Use `./run.sh --help` for more information.

### Speak Mode

Enter this command to use TTS _(Text-to-Speech)_ for AutoGPT

```shell
./run.sh --speak
```

### 💀 Continuous Mode ⚠️

Run the AI **without** user authorization, 100% automated.
Continuous mode is NOT recommended.
It is potentially dangerous and may cause your AI to run forever or carry out actions you would not usually authorize.
Use at your own risk.

```shell
./run.sh --continuous
```

To exit the program, press ++ctrl+c++

### ♻️ Self-Feedback Mode ⚠️

Running Self-Feedback will **INCREASE** token use and thus cost more. This feature enables the agent to provide self-feedback by verifying its own actions and checking if they align with its current goals. If not, it will provide better feedback for the next loop. To enable this feature for the current loop, input `S` into the input field.

### GPT-3.5 ONLY Mode

If you don't have access to GPT-4, this mode allows you to use AutoGPT!

```shell
./run.sh --gpt3only
```

You can achieve the same by setting `SMART_LLM` in `.env` to `gpt-3.5-turbo`.

### GPT-4 ONLY Mode

If you have access to GPT-4, this mode allows you to use AutoGPT solely with GPT-4.
This may give your bot increased intelligence.

```shell
./run.sh --gpt4only
```

!!! warning
    Since GPT-4 is more expensive to use, running AutoGPT in GPT-4-only mode will
    increase your API costs.

## Logs

Activity, Error, and Debug logs are located in `./logs`

!!! tip 
    Do you notice weird behavior with your agent? Do you have an interesting use case? Do you have a bug you want to report?
    Follow the step below to enable your logs. You can include these logs when making an issue report or discussing an issue with us.

To print out debug logs:

```shell
./run.sh --debug     # on Linux / macOS

.\run.bat --debug    # on Windows

docker-compose run --rm auto-gpt --debug    # in Docker
```

## Disabling Command Categories

If you want to selectively disable some command groups, you can use the `DISABLED_COMMAND_CATEGORIES` config in your `.env`. You can find the list of categories in your `.env.template`

For example, to disable coding related features, set it to the value below:

```ini
DISABLED_COMMAND_CATEGORIES=autogpt.commands.execute_code
```