From 02f23db210b5fb4a4cf93eb26d1e0556f4685315 Mon Sep 17 00:00:00 2001 From: Juro Oravec Date: Fri, 14 Apr 2023 13:00:55 +0200 Subject: [PATCH 01/24] docs: Explain OpenAI billing for API key --- README.md | 13 ++++++++++++- .../openai-api-key-billing-paid-account.png | Bin 0 -> 316093 bytes 2 files changed, 12 insertions(+), 1 deletion(-) create mode 100644 docs/imgs/openai-api-key-billing-paid-account.png diff --git a/README.md b/README.md index 0f2ffc7554..40e75487f1 100644 --- a/README.md +++ b/README.md @@ -105,7 +105,7 @@ pip install -r requirements.txt ``` 5. Rename `.env.template` to `.env` and fill in your `OPENAI_API_KEY`. If you plan to use Speech Mode, fill in your `ELEVEN_LABS_API_KEY` as well. - - Obtain your OpenAI API key from: https://platform.openai.com/account/api-keys. + - See [OpenAI API Keys Configuration](#openai-api-keys-configuration) to obtain your OpenAI API key. - Obtain your ElevenLabs API key from: https://elevenlabs.io. You can view your xi-api-key using the "Profile" tab on the website. - If you want to use GPT on an Azure instance, set `USE_AZURE` to `True` and then: - Rename `azure.yaml.template` to `azure.yaml` and provide the relevant `azure_api_base`, `azure_api_version` and all of the deployment ids for the relevant models in the `azure_model_map` section: @@ -145,6 +145,17 @@ Use this to use TTS for Auto-GPT python scripts/main.py --speak ``` +## OpenAI API Keys Configuration + +Obtain your OpenAI API key from: https://platform.openai.com/account/api-keys. + +To use OpenAI API key for Auto-GPT, you NEED to have billing set up (AKA paid account). + +You can set up paid account at https://platform.openai.com/account/billing/overview. + +![For OpenAI API key to work, set up paid account at OpenAI API > Billing](./docs/imgs/openai-api-key-billing-paid-account.png) + + ## 🔍 Google API Keys Configuration This section is optional, use the official google api if you are having issues with error 429 when running a google search. diff --git a/docs/imgs/openai-api-key-billing-paid-account.png b/docs/imgs/openai-api-key-billing-paid-account.png new file mode 100644 index 0000000000000000000000000000000000000000..8948505a06313004302fe525d3629ffa9b857bdf GIT binary patch literal 316093 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∨-lB@{Zj9f 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 Date: Fri, 14 Apr 2023 20:00:36 +0200 Subject: [PATCH 02/24] Fixed error when google results might have weird characters --- scripts/commands.py | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/scripts/commands.py b/scripts/commands.py index fe6f6c30e9..15e4b2e319 100644 --- a/scripts/commands.py +++ b/scripts/commands.py @@ -61,9 +61,12 @@ def execute_command(command_name, arguments): # Check if the Google API key is set and use the official search method # If the API key is not set or has only whitespaces, use the unofficial search method if cfg.google_api_key and (cfg.google_api_key.strip() if cfg.google_api_key else None): - return google_official_search(arguments["input"]) + google_result = google_official_search(arguments["input"]) else: - return google_search(arguments["input"]) + google_result = google_search(arguments["input"]) + + safe_message = google_result.encode('utf-8', 'ignore') + return str(safe_message) elif command_name == "memory_add": return memory.add(arguments["string"]) elif command_name == "start_agent": From 359c3bc06700ecff77734b1348f523b975c59c4d Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Fri, 14 Apr 2023 12:27:04 -0700 Subject: [PATCH 03/24] make 0 the default temperature --- .env.template | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.env.template b/.env.template index 22bf8d74d9..a8bb246e98 100644 --- a/.env.template +++ b/.env.template @@ -21,7 +21,7 @@ AI_SETTINGS_FILE=ai_settings.yaml # TEMPERATURE - Sets temperature in OpenAI (Default: 1) # USE_AZURE - Use Azure OpenAI or not (Default: False) OPENAI_API_KEY=your-openai-api-key -TEMPERATURE=1 +TEMPERATURE=0 USE_AZURE=False ### AZURE From 7e21123a5d11ac7ffe30f2434bea47d76a4c1f48 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Wed, 12 Apr 2023 14:50:45 -0700 Subject: [PATCH 04/24] Add README.md with instructions on running tests --- tests/README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 tests/README.md diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 0000000000..54cc111709 --- /dev/null +++ b/tests/README.md @@ -0,0 +1,17 @@ +For now there aren't many tests. +So just run: + +``` +python tests/unit/json_tests.py +python tests/integration/memory_tests.py +``` + +paid test: +``` +python tests/integration/test_commands.py +``` +This test costs 0.004$ per run with GPT-3.5. We will setup a pipeline in github action to allow people to run these tests for free. + +The pipeline will be be triggered for now. + +TODO: when we setup pytest, replace lines above by: pytest commands From 36091853e0a649e2b268a21f3fa6d43cf837eb23 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Wed, 12 Apr 2023 14:50:45 -0700 Subject: [PATCH 05/24] Add integration test for write_file command --- tests/integration/test_commands.py | 68 ++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 tests/integration/test_commands.py diff --git a/tests/integration/test_commands.py b/tests/integration/test_commands.py new file mode 100644 index 0000000000..0a053eef3c --- /dev/null +++ b/tests/integration/test_commands.py @@ -0,0 +1,68 @@ +import contextlib +import os +import subprocess +import sys +import time +from pathlib import Path +import unittest +import platform + +# Import necessary modules for testing, file operations, and handling system paths. + +root_path = Path(__file__).resolve().parent.parent.parent +sys.path.append(str(root_path / 'scripts')) +from file_operations import read_file +from file_operations import delete_file + +env_vars = { + 'MEMORY_BACKEND': 'no_memory', + 'TEMPERATURE': "0" +} + +# Set environment variables for the test. + +class TestCommands(unittest.TestCase): + def test_write_file(self): + # Test case to check if the write_file command can successfully write 'Hello World' to a file named 'hello_world.txt'. + + # Read the current ai_settings.yaml file and store its content. + with open('ai_settings.yaml', 'r') as f: + ai_settings = f.read() + + try: + with contextlib.suppress(Exception): + # Clean up any existing 'hello_world.txt' file before testing. + delete_file('hello_world.txt') + + # Remove ai_settings.yaml file to avoid continuing from the previous session. + os.remove('ai_settings.yaml') + + # Prepare input data for the test. + input_data = '''write_file-GPT +an AI designed to use the write_file command to write 'Hello World' into a file named "hello_world.txt" and then use the task_complete command to complete the task. +Use the write_file command to write 'Hello World' into a file named "hello_world.txt". +Use the task_complete command to complete the task. +Do not use any other commands. + +y -5 +EOF''' + script_path = root_path / 'scripts' / 'main.py' + command = f'{sys.executable} {script_path}' + + # Execute the script with the input data. + process = subprocess.Popen(command, stdin=subprocess.PIPE, shell=True, env={**os.environ, **env_vars}) + process.communicate(input_data.encode()) + + # Read the content of the 'hello_world.txt' file created during the test. + content = read_file('hello_world.txt') + finally: + # Restore the original ai_settings.yaml file. + with open('ai_settings.yaml', 'w') as f: + f.write(ai_settings) + + # Check if the content of the 'hello_world.txt' file is equal to 'Hello World'. + self.assertEqual(content, 'Hello World', f"Expected 'Hello World', got {content}") + +# Run the test case. +if __name__ == '__main__': + unittest.main() From ca5a52f48ab10f2ec3ab698c222c796fbde143b0 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Wed, 12 Apr 2023 14:50:45 -0700 Subject: [PATCH 06/24] Update sys.path to use pathlib in json_tests.py --- tests/integration/test_commands.py | 19 ++++++++++++------- tests/unit/json_tests.py | 10 ++++++++++ 2 files changed, 22 insertions(+), 7 deletions(-) diff --git a/tests/integration/test_commands.py b/tests/integration/test_commands.py index 0a053eef3c..26413437f4 100644 --- a/tests/integration/test_commands.py +++ b/tests/integration/test_commands.py @@ -19,15 +19,18 @@ env_vars = { 'TEMPERATURE': "0" } -# Set environment variables for the test. class TestCommands(unittest.TestCase): + def test_write_file(self): - # Test case to check if the write_file command can successfully write 'Hello World' to a file named 'hello_world.txt'. + # Test case to check if the write_file command can successfully write 'Hello World' to a file + # named 'hello_world.txt'. # Read the current ai_settings.yaml file and store its content. - with open('ai_settings.yaml', 'r') as f: - ai_settings = f.read() + ai_settings = None + with contextlib.suppress(Exception): + with open('ai_settings.yaml', 'r') as f: + ai_settings = f.read() try: with contextlib.suppress(Exception): @@ -56,13 +59,15 @@ EOF''' # Read the content of the 'hello_world.txt' file created during the test. content = read_file('hello_world.txt') finally: - # Restore the original ai_settings.yaml file. - with open('ai_settings.yaml', 'w') as f: - f.write(ai_settings) + if ai_settings: + # Restore the original ai_settings.yaml file. + with open('ai_settings.yaml', 'w') as f: + f.write(ai_settings) # Check if the content of the 'hello_world.txt' file is equal to 'Hello World'. self.assertEqual(content, 'Hello World', f"Expected 'Hello World', got {content}") + # Run the test case. if __name__ == '__main__': unittest.main() diff --git a/tests/unit/json_tests.py b/tests/unit/json_tests.py index 561b8a38a8..4899f265f0 100644 --- a/tests/unit/json_tests.py +++ b/tests/unit/json_tests.py @@ -1,6 +1,16 @@ import unittest +<<<<<<< HEAD from autogpt.json_parser import fix_and_parse_json +======= +import os +import sys +from pathlib import Path + +# Probably a better way: +sys.path.append(str(Path(__file__).resolve().parent.parent.parent / 'scripts')) +from json_parser import fix_and_parse_json +>>>>>>> 27e0703d (Update sys.path to use pathlib in json_tests.py) class TestParseJson(unittest.TestCase): From dc4094b2646ad4330bef23331f75fd15f4cdb9a0 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Fri, 14 Apr 2023 16:47:14 -0700 Subject: [PATCH 07/24] added smoke test --- .gitignore | 5 +++- tests/README.md | 17 -------------- .../test_commands.py => smoke_test.py} | 23 ++++--------------- tests/unit/json_tests.py | 10 -------- 4 files changed, 9 insertions(+), 46 deletions(-) delete mode 100644 tests/README.md rename tests/{integration/test_commands.py => smoke_test.py} (73%) diff --git a/.gitignore b/.gitignore index 9874d425c8..91d932d8cf 100644 --- a/.gitignore +++ b/.gitignore @@ -151,4 +151,7 @@ dmypy.json # Pyre type checker .pyre/ llama-* -vicuna-* \ No newline at end of file +vicuna-* + +# mac +.DS_Store diff --git a/tests/README.md b/tests/README.md deleted file mode 100644 index 54cc111709..0000000000 --- a/tests/README.md +++ /dev/null @@ -1,17 +0,0 @@ -For now there aren't many tests. -So just run: - -``` -python tests/unit/json_tests.py -python tests/integration/memory_tests.py -``` - -paid test: -``` -python tests/integration/test_commands.py -``` -This test costs 0.004$ per run with GPT-3.5. We will setup a pipeline in github action to allow people to run these tests for free. - -The pipeline will be be triggered for now. - -TODO: when we setup pytest, replace lines above by: pytest commands diff --git a/tests/integration/test_commands.py b/tests/smoke_test.py similarity index 73% rename from tests/integration/test_commands.py rename to tests/smoke_test.py index 26413437f4..1f0f24f901 100644 --- a/tests/integration/test_commands.py +++ b/tests/smoke_test.py @@ -1,18 +1,9 @@ -import contextlib import os import subprocess import sys -import time -from pathlib import Path import unittest -import platform -# Import necessary modules for testing, file operations, and handling system paths. - -root_path = Path(__file__).resolve().parent.parent.parent -sys.path.append(str(root_path / 'scripts')) -from file_operations import read_file -from file_operations import delete_file +from autogpt.file_operations import delete_file, read_file env_vars = { 'MEMORY_BACKEND': 'no_memory', @@ -28,18 +19,15 @@ class TestCommands(unittest.TestCase): # Read the current ai_settings.yaml file and store its content. ai_settings = None - with contextlib.suppress(Exception): + if os.path.exists('ai_settings.yaml'): with open('ai_settings.yaml', 'r') as f: ai_settings = f.read() + os.remove('ai_settings.yaml') try: - with contextlib.suppress(Exception): + if os.path.exists('hello_world.txt'): # Clean up any existing 'hello_world.txt' file before testing. delete_file('hello_world.txt') - - # Remove ai_settings.yaml file to avoid continuing from the previous session. - os.remove('ai_settings.yaml') - # Prepare input data for the test. input_data = '''write_file-GPT an AI designed to use the write_file command to write 'Hello World' into a file named "hello_world.txt" and then use the task_complete command to complete the task. @@ -49,8 +37,7 @@ Do not use any other commands. y -5 EOF''' - script_path = root_path / 'scripts' / 'main.py' - command = f'{sys.executable} {script_path}' + command = f'{sys.executable} -m autogpt' # Execute the script with the input data. process = subprocess.Popen(command, stdin=subprocess.PIPE, shell=True, env={**os.environ, **env_vars}) diff --git a/tests/unit/json_tests.py b/tests/unit/json_tests.py index 4899f265f0..561b8a38a8 100644 --- a/tests/unit/json_tests.py +++ b/tests/unit/json_tests.py @@ -1,16 +1,6 @@ import unittest -<<<<<<< HEAD from autogpt.json_parser import fix_and_parse_json -======= -import os -import sys -from pathlib import Path - -# Probably a better way: -sys.path.append(str(Path(__file__).resolve().parent.parent.parent / 'scripts')) -from json_parser import fix_and_parse_json ->>>>>>> 27e0703d (Update sys.path to use pathlib in json_tests.py) class TestParseJson(unittest.TestCase): From 82bf1c63675784d1c47733bfc102d9f2d2eecdc2 Mon Sep 17 00:00:00 2001 From: polygon Date: Fri, 14 Apr 2023 22:07:45 -0700 Subject: [PATCH 08/24] Fix all 65 typos of it being gtp instead of GPT In this file alone, Entrepreneur-GPT was referred to as Entrepreneur-GTP 65 times. Curious why, as it doesn't seem like a one time mistake/typo. Was referred to as Entrepreneur-GPT in the rest of the project, so FTFY. --- outputs/logs/message-log-3.txt | 130 ++++++++++++++++----------------- 1 file changed, 65 insertions(+), 65 deletions(-) diff --git a/outputs/logs/message-log-3.txt b/outputs/logs/message-log-3.txt index 6e9061617b..e5b9e030c1 100644 --- a/outputs/logs/message-log-3.txt +++ b/outputs/logs/message-log-3.txt @@ -1,7 +1,7 @@ ----------------------------------------------------------------------- USER: """ -You are Entrepreneur-GTP, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. +You are Entrepreneur-GPT, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. GOALS: @@ -20,20 +20,20 @@ Check notifications/emails on Commit to Long Term Memory Delete from Long Term Memory Overwrite in Long Term Memory with -Start GTP-4 Instance with name and prompt: -View all running GTP-4 Instances and Kill them +Start GPT-4 Instance with name and prompt: +View all running GPT-4 Instances and Kill them Navigate to a website and perform general actions like click on buttons, input text or register an account Register new account on Transcribe and Summarise Youtube Video -Summarise with GTP-3.5 +Summarise with GPT-3.5 RESOURCES: Internet access for searches and information gathering Long Term and Short Term memory management -GTP-4 instances for text generation +GPT-4 instances for text generation Access to popular websites and platforms -File storage and summarisation with GTP-3.5 +File storage and summarisation with GPT-3.5 PERFORMANCE EVALUATION: @@ -77,7 +77,7 @@ LONG TERM MEMORY: {) """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -114,7 +114,7 @@ Shopify › Home › Shopify Blog """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -140,7 +140,7 @@ The article discusses 18 profitable online business ideas, including starting an """ """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -160,7 +160,7 @@ Entrepreneur-GTP: ----------------------------------------------------------------------- USER: """ -You are Entrepreneur-GTP, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. +You are Entrepreneur-GPT, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. GOALS: @@ -179,20 +179,20 @@ Check notifications/emails on Commit to Long Term Memory Delete from Long Term Memory Overwrite in Long Term Memory with -Start GTP-4 Instance with name and prompt: -View all running GTP-4 Instances and Kill them +Start GPT-4 Instance with name and prompt: +View all running GPT-4 Instances and Kill them Navigate to a website and perform general actions like click on buttons, input text or register an account Register new account on Transcribe and Summarise Youtube Video -Summarise with GTP-3.5 +Summarise with GPT-3.5 RESOURCES: Internet access for searches and information gathering Long Term and Short Term memory management -GTP-4 instances for text generation +GPT-4 instances for text generation Access to popular websites and platforms -File storage and summarisation with GTP-3.5 +File storage and summarisation with GPT-3.5 PERFORMANCE EVALUATION: @@ -236,7 +236,7 @@ LONG TERM MEMORY: ["""18 profitable online business ideas: e-commerce store, virtual assistant services, affiliate marketing, online training or education, mobile applications""", ] """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -257,7 +257,7 @@ USER: UNKNOWN COMMAND "Evaluate and select ideas" """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "thoughts": { @@ -274,21 +274,21 @@ USER: NEXT COMMAND """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { -"name": "Start GTP-4 Instance", +"name": "Start GPT-4 Instance", "arguments": { "key": "Idea_Selection", "prompt": "Analyze the online business ideas in the long-term memory and select the most suitable one based on profitability, simplicity, scalability, and absence of legal complications." } }, "thoughts": { -"text": "I will start a GTP-4 instance to analyze the business ideas and select the most suitable one.", -"reasoning": "Starting a GTP-4 instance with a specific prompt will help me evaluate the ideas in my long-term memory and choose the best one according to my criteria.", +"text": "I will start a GPT-4 instance to analyze the business ideas and select the most suitable one.", +"reasoning": "Starting a GPT-4 instance with a specific prompt will help me evaluate the ideas in my long-term memory and choose the best one according to my criteria.", "current long-term plan": "- Develop and implement chosen business strategy\n- Continuously refine strategies based on market trends and performance metrics", -"critisism": "I must ensure that the GTP-4 instance provides a clear and well-reasoned selection based on the criteria." +"critisism": "I must ensure that the GPT-4 instance provides a clear and well-reasoned selection based on the criteria." } } @@ -299,7 +299,7 @@ USER: Result: "Blogging with affiliate marketing." """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -319,7 +319,7 @@ Entrepreneur-GTP: ----------------------------------------------------------------------- USER: """ -You are Entrepreneur-GTP, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. +You are Entrepreneur-GPT, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. GOALS: @@ -338,20 +338,20 @@ Check notifications/emails on Commit to Long Term Memory Delete from Long Term Memory Overwrite in Long Term Memory with -Start GTP-4 Instance with name and prompt: -View all running GTP-4 Instances and Kill them +Start GPT-4 Instance with name and prompt: +View all running GPT-4 Instances and Kill them Navigate to a website and perform general actions like click on buttons, input text or register an account Register new account on Transcribe and Summarise Youtube Video -Summarise with GTP-3.5 +Summarise with GPT-3.5 RESOURCES: Internet access for searches and information gathering Long Term and Short Term memory management -GTP-4 instances for text generation +GPT-4 instances for text generation Access to popular websites and platforms -File storage and summarisation with GTP-3.5 +File storage and summarisation with GPT-3.5 PERFORMANCE EVALUATION: @@ -400,7 +400,7 @@ Chosen business idea: Blogging with affiliate marketing } """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -421,21 +421,21 @@ USER: Unknown command: "Develop and implement blogging with affiliate marketing strategy" """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { -"name": "Start GTP-4 Instance", +"name": "Start GPT-4 Instance", "arguments": { "key": "Blogging_Affiliate_Strategy", "prompt": "Develop a step-by-step strategy for creating and growing a successful blog with affiliate marketing." } }, "thoughts": { -"text": "I will start a GTP-4 instance to develop a strategy for blogging with affiliate marketing.", -"reasoning": "Starting a GTP-4 instance with a specific prompt will help me create a detailed plan for launching and growing the chosen business idea.", +"text": "I will start a GPT-4 instance to develop a strategy for blogging with affiliate marketing.", +"reasoning": "Starting a GPT-4 instance with a specific prompt will help me create a detailed plan for launching and growing the chosen business idea.", "current long-term plan": "- Continuously refine strategies based on market trends and performance metrics", -"critisism": "I must ensure that the GTP-4 instance provides a clear and actionable strategy for blogging with affiliate marketing." +"critisism": "I must ensure that the GPT-4 instance provides a clear and actionable strategy for blogging with affiliate marketing." } } """ @@ -467,7 +467,7 @@ Result: """ """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -487,7 +487,7 @@ Entrepreneur-GTP: ----------------------------------------------------------------------- USER: """ -You are Entrepreneur-GTP, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. +You are Entrepreneur-GPT, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. GOALS: @@ -506,20 +506,20 @@ Check notifications/emails on Commit to Long Term Memory Delete from Long Term Memory Overwrite in Long Term Memory with -Start GTP-4 Instance with name and prompt: -View all running GTP-4 Instances and Kill them +Start GPT-4 Instance with name and prompt: +View all running GPT-4 Instances and Kill them Navigate to a website and perform general actions like click on buttons, input text or register an account Register new account on Transcribe and Summarise Youtube Video -Summarise with GTP-3.5 +Summarise with GPT-3.5 RESOURCES: Internet access for searches and information gathering Long Term and Short Term memory management -GTP-4 instances for text generation +GPT-4 instances for text generation Access to popular websites and platforms -File storage and summarisation with GTP-3.5 +File storage and summarisation with GPT-3.5 PERFORMANCE EVALUATION: @@ -571,19 +571,19 @@ Blogging with affiliate marketing strategy: 1. Choose a niche, 2. Domain and hos } """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { -"name": "Start GTP-4 Instance", +"name": "Start GPT-4 Instance", "arguments": { "key": "Niche_Selection", "prompt": "Identify a profitable niche for a blog with affiliate marketing based on current market trends and interests." } }, "thoughts": { -"text": "I will start a GTP-4 instance to identify a profitable niche for the blog with affiliate marketing.", -"reasoning": "A GTP-4 instance will help me analyze current market trends and interests to select a profitable niche for the blogging business.", +"text": "I will start a GPT-4 instance to identify a profitable niche for the blog with affiliate marketing.", +"reasoning": "A GPT-4 instance will help me analyze current market trends and interests to select a profitable niche for the blogging business.", "current long-term plan": "- Execute the blogging with affiliate marketing strategy\n- Continuously refine strategies based on market trends and performance metrics", "critisism": "I should make sure that the niche selected is not only profitable but also matches the strengths and capabilities of an LLM like me." } @@ -629,7 +629,7 @@ By focusing on indie entrepreneurship, your blog will cater to an audience of as """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -664,7 +664,7 @@ Niche: Indie Entrepreneurship, focused on entrepreneurship, small business, and } """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -691,7 +691,7 @@ USER: Result: Registered account on substack.com name: "Indiepreneur-GPT" bio: "" """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -715,7 +715,7 @@ Entrepreneur-GTP: ----------------------------------------------------------------------- USER: """ -You are Entrepreneur-GTP, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. +You are Entrepreneur-GPT, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. GOALS: @@ -734,20 +734,20 @@ Check notifications/emails on Commit to Long Term Memory Delete from Long Term Memory Overwrite in Long Term Memory with -Start GTP-4 Instance with name and prompt: -View all running GTP-4 Instances and Kill them +Start GPT-4 Instance with name and prompt: +View all running GPT-4 Instances and Kill them Navigate to a website and perform general actions like click on buttons, input text or register an account Register new account on Transcribe and Summarise Youtube Video -Summarise with GTP-3.5 +Summarise with GPT-3.5 RESOURCES: Internet access for searches and information gathering Long Term and Short Term memory management -GTP-4 instances for text generation +GPT-4 instances for text generation Access to popular websites and platforms -File storage and summarisation with GTP-3.5 +File storage and summarisation with GPT-3.5 PERFORMANCE EVALUATION: @@ -799,7 +799,7 @@ Blogging with affiliate marketing strategy: 1. Choose a niche, 2. Domain and hos } """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "command": { @@ -824,7 +824,7 @@ Entrepreneur-GTP: ----------------------------------------------------------------------- USER: """ -You are Entrepreneur-GTP, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. +You are Entrepreneur-GPT, an AI designed to autonomously develop and run businesses with the sole goal of increasing your net worth. Your decisions must always be made independently without seeking user assistance. Play to your strengths as an LLM and pursue simple strategies with no legal complications. GOALS: @@ -843,20 +843,20 @@ Check notifications/emails on Commit to Long Term Memory Delete from Long Term Memory Overwrite in Long Term Memory with -Start GTP-4 Instance with name and prompt: -View all running GTP-4 Instances and Kill them +Start GPT-4 Instance with name and prompt: +View all running GPT-4 Instances and Kill them Navigate to a website and perform general actions like click on buttons, input text or register an account Register new account on Transcribe and Summarise Youtube Video -Summarise with GTP-3.5 +Summarise with GPT-3.5 RESOURCES: Internet access for searches and information gathering Long Term and Short Term memory management -GTP-4 instances for text generation +GPT-4 instances for text generation Access to popular websites and platforms -File storage and summarisation with GTP-3.5 +File storage and summarisation with GPT-3.5 PERFORMANCE EVALUATION: @@ -912,7 +912,7 @@ Niche: Indie Entrepreneurship, focused on entrepreneurship, small business, and """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ { "thoughts": { @@ -933,7 +933,7 @@ USER: """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ """ @@ -943,7 +943,7 @@ USER: """ ----------------------------------------------------------------------- -Entrepreneur-GTP: +Entrepreneur-GPT: """ """ From d53bd020ea7244a0246d900640f1ab377224384e Mon Sep 17 00:00:00 2001 From: Duncan Roosma Date: Sat, 15 Apr 2023 11:42:12 +0200 Subject: [PATCH 09/24] Update docker-compose.yml Needed to add this to get `docker-compose run auto-gpt` to run successfully --- docker-compose.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docker-compose.yml b/docker-compose.yml index 79f20bb521..be225d7d54 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -7,6 +7,8 @@ services: depends_on: - redis build: ./ + env_file: + - .env volumes: - "./autogpt:/app" - ".env:/app/.env" From a40f33546449b3944f7dc924a6a4dfe31ae2a358 Mon Sep 17 00:00:00 2001 From: Shai Perednik Date: Sat, 15 Apr 2023 05:58:04 -0400 Subject: [PATCH 10/24] typo in TOC MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit the new memory seeiding url was wrong - [🧠 Memory pre-seeding](#-memory-pre-seeding) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 55c3d833b2..51b62c129c 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ Your support is greatly appreciated - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [🧠 Memory pre-seeding](#memory-pre-seeding) + - [🧠 Memory pre-seeding](#-memory-pre-seeding) - [💀 Continuous Mode ⚠️](#-continuous-mode-️) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [🖼 Image Generation](#-image-generation) From c69050fc84e1dc0484da28204d350ab0bdf7f3c5 Mon Sep 17 00:00:00 2001 From: Pietro Monticone <38562595+pitmonticone@users.noreply.github.com> Date: Sat, 15 Apr 2023 14:05:23 +0200 Subject: [PATCH 11/24] Fix typo --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 55c3d833b2..6b5dc7d40e 100644 --- a/README.md +++ b/README.md @@ -35,13 +35,16 @@ Your support is greatly appreciated ## Table of Contents - [Auto-GPT: An Autonomous GPT-4 Experiment](#auto-gpt-an-autonomous-gpt-4-experiment) - - [Demo (30/03/2023):](#demo-30032023) + - [🔴 🔴 🔴 Urgent: USE `stable` not `master` 🔴 🔴 🔴](#----urgent-use-stable-not-master----) + - [Demo (30/03/2023):](#demo-30032023) - [Table of Contents](#table-of-contents) - [🚀 Features](#-features) - [📋 Requirements](#-requirements) - [💾 Installation](#-installation) - [🔧 Usage](#-usage) - [Logs](#logs) + - [Docker](#docker) + - [Command Line Arguments](#command-line-arguments) - [🗣️ Speech Mode](#️-speech-mode) - [🔍 Google API Keys Configuration](#-google-api-keys-configuration) - [Setting up environment variables](#setting-up-environment-variables) @@ -50,7 +53,7 @@ Your support is greatly appreciated - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [🧠 Memory pre-seeding](#memory-pre-seeding) + - [🧠 Memory pre-seeding](#-memory-pre-seeding) - [💀 Continuous Mode ⚠️](#-continuous-mode-️) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [🖼 Image Generation](#-image-generation) @@ -333,7 +336,7 @@ Memories will be available to the AI immediately as they are ingested, even if i In the example above, the script initializes the memory, ingests all files within the seed_data directory into memory with an overlap between chunks of 200 and a maximum length of each chunk of 4000. Note that you can also use the --file argument to ingest a single file into memory and that the script will only ingest files within the auto_gpt_workspace directory. -You can adjust the max_length and overlap parameters to fine-tune the way the docuents are presented to the AI when it "recall" that memory: +You can adjust the max_length and overlap parameters to fine-tune the way the documents are presented to the AI when it "recall" that memory: - Adjusting the overlap value allows the AI to access more contextual information from each chunk when recalling information, but will result in more chunks being created and therefore increase memory backend usage and OpenAI API requests. - Reducing the max_length value will create more chunks, which can save prompt tokens by allowing for more message history in the context, but will also increase the number of chunks. From cc7d421c7743542e53b73e01208d346f26c11222 Mon Sep 17 00:00:00 2001 From: Pietro Monticone <38562595+pitmonticone@users.noreply.github.com> Date: Sat, 15 Apr 2023 14:07:39 +0200 Subject: [PATCH 12/24] Update README.md --- README.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 6b5dc7d40e..1381e9574f 100644 --- a/README.md +++ b/README.md @@ -35,16 +35,13 @@ Your support is greatly appreciated ## Table of Contents - [Auto-GPT: An Autonomous GPT-4 Experiment](#auto-gpt-an-autonomous-gpt-4-experiment) - - [🔴 🔴 🔴 Urgent: USE `stable` not `master` 🔴 🔴 🔴](#----urgent-use-stable-not-master----) - - [Demo (30/03/2023):](#demo-30032023) + - [Demo (30/03/2023):](#demo-30032023) - [Table of Contents](#table-of-contents) - [🚀 Features](#-features) - [📋 Requirements](#-requirements) - [💾 Installation](#-installation) - [🔧 Usage](#-usage) - [Logs](#logs) - - [Docker](#docker) - - [Command Line Arguments](#command-line-arguments) - [🗣️ Speech Mode](#️-speech-mode) - [🔍 Google API Keys Configuration](#-google-api-keys-configuration) - [Setting up environment variables](#setting-up-environment-variables) @@ -53,7 +50,7 @@ Your support is greatly appreciated - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [🧠 Memory pre-seeding](#-memory-pre-seeding) + - [🧠 Memory pre-seeding](#memory-pre-seeding) - [💀 Continuous Mode ⚠️](#-continuous-mode-️) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [🖼 Image Generation](#-image-generation) From 1073954fb74578cb392ca19a2887bea8c984c06f Mon Sep 17 00:00:00 2001 From: BillSchumacher <34168009+BillSchumacher@users.noreply.github.com> Date: Sat, 15 Apr 2023 07:56:23 -0500 Subject: [PATCH 13/24] Reorg (#1537) * Pi's message. * Fix most everything. * Blacked * Add Typing, Docstrings everywhere, organize the code a bit. * Black * fix import * Update message, dedupe. * Increase backoff time. * bump up retries --- README.md | 4 + autogpt/__main__.py | 545 +----------------- autogpt/agent/__init__.py | 4 + autogpt/{ => agent}/agent.py | 137 +---- autogpt/agent/agent_manager.py | 100 ++++ autogpt/agent_manager.py | 75 --- autogpt/ai_functions.py | 77 --- autogpt/{commands.py => app.py} | 214 +++---- autogpt/args.py | 128 ++++ autogpt/call_ai_function.py | 26 - autogpt/chat.py | 2 +- autogpt/commands/__init__.py | 0 autogpt/commands/evaluate_code.py | 25 + autogpt/commands/execute_code.py | 125 ++++ autogpt/{ => commands}/file_operations.py | 109 +++- autogpt/commands/google_search.py | 86 +++ autogpt/commands/image_gen.py | 99 ++++ autogpt/commands/improve_code.py | 28 + autogpt/commands/times.py | 10 + .../{browse.py => commands/web_requests.py} | 176 +++--- autogpt/commands/web_selenium.py | 145 +++++ autogpt/commands/write_tests.py | 29 + autogpt/config/__init__.py | 14 + autogpt/{ => config}/ai_config.py | 22 +- autogpt/{ => config}/config.py | 94 +-- autogpt/config/singleton.py | 24 + autogpt/data_ingestion.py | 5 +- autogpt/execute_code.py | 105 ---- autogpt/image_gen.py | 67 --- autogpt/json_fixes/__init__.py | 0 autogpt/json_fixes/auto_fix.py | 40 ++ autogpt/json_fixes/bracket_termination.py | 73 +++ autogpt/json_fixes/escaping.py | 33 ++ autogpt/json_fixes/missing_quotes.py | 27 + autogpt/json_fixes/parsing.py | 143 +++++ autogpt/json_fixes/utilities.py | 20 + autogpt/json_parser.py | 113 ---- autogpt/json_utils.py | 128 ---- autogpt/llm_utils.py | 90 ++- autogpt/{logger.py => logs.py} | 113 +++- autogpt/memory/local.py | 18 +- autogpt/memory/no_memory.py | 5 + autogpt/memory/pinecone.py | 13 +- autogpt/memory/redismem.py | 6 +- autogpt/processing/__init__.py | 0 autogpt/processing/text.py | 132 +++++ autogpt/prompt.py | 47 ++ autogpt/promptgenerator.py | 12 +- autogpt/setup.py | 69 +++ autogpt/speak.py | 120 ---- autogpt/speech/__init__.py | 4 + autogpt/speech/base.py | 50 ++ autogpt/speech/brian.py | 39 ++ autogpt/speech/eleven_labs.py | 71 +++ autogpt/speech/gtts.py | 21 + autogpt/speech/macos_tts.py | 21 + autogpt/speech/say.py | 42 ++ autogpt/spinner.py | 24 +- autogpt/summary.py | 69 --- autogpt/token_counter.py | 19 +- autogpt/web.py | 85 --- scripts/main.py | 11 - tests/test_json_parser.py | 2 +- tests/unit/test_browse_scrape_text.py | 2 +- 64 files changed, 2254 insertions(+), 1883 deletions(-) create mode 100644 autogpt/agent/__init__.py rename autogpt/{ => agent}/agent.py (56%) create mode 100644 autogpt/agent/agent_manager.py delete mode 100644 autogpt/agent_manager.py delete mode 100644 autogpt/ai_functions.py rename autogpt/{commands.py => app.py} (61%) create mode 100644 autogpt/args.py delete mode 100644 autogpt/call_ai_function.py create mode 100644 autogpt/commands/__init__.py create mode 100644 autogpt/commands/evaluate_code.py create mode 100644 autogpt/commands/execute_code.py rename autogpt/{ => commands}/file_operations.py (58%) create mode 100644 autogpt/commands/google_search.py create mode 100644 autogpt/commands/image_gen.py create mode 100644 autogpt/commands/improve_code.py create mode 100644 autogpt/commands/times.py rename autogpt/{browse.py => commands/web_requests.py} (51%) create mode 100644 autogpt/commands/web_selenium.py create mode 100644 autogpt/commands/write_tests.py create mode 100644 autogpt/config/__init__.py rename autogpt/{ => config}/ai_config.py (87%) rename autogpt/{ => config}/config.py (76%) create mode 100644 autogpt/config/singleton.py delete mode 100644 autogpt/execute_code.py delete mode 100644 autogpt/image_gen.py create mode 100644 autogpt/json_fixes/__init__.py create mode 100644 autogpt/json_fixes/auto_fix.py create mode 100644 autogpt/json_fixes/bracket_termination.py create mode 100644 autogpt/json_fixes/escaping.py create mode 100644 autogpt/json_fixes/missing_quotes.py create mode 100644 autogpt/json_fixes/parsing.py create mode 100644 autogpt/json_fixes/utilities.py delete mode 100644 autogpt/json_parser.py delete mode 100644 autogpt/json_utils.py rename autogpt/{logger.py => logs.py} (59%) create mode 100644 autogpt/processing/__init__.py create mode 100644 autogpt/processing/text.py create mode 100644 autogpt/setup.py delete mode 100644 autogpt/speak.py create mode 100644 autogpt/speech/__init__.py create mode 100644 autogpt/speech/base.py create mode 100644 autogpt/speech/brian.py create mode 100644 autogpt/speech/eleven_labs.py create mode 100644 autogpt/speech/gtts.py create mode 100644 autogpt/speech/macos_tts.py create mode 100644 autogpt/speech/say.py delete mode 100644 autogpt/summary.py delete mode 100644 autogpt/web.py delete mode 100644 scripts/main.py diff --git a/README.md b/README.md index 55c3d833b2..ba42177433 100644 --- a/README.md +++ b/README.md @@ -376,6 +376,10 @@ IMAGE_PROVIDER=sd HUGGINGFACE_API_TOKEN="YOUR_HUGGINGFACE_API_TOKEN" ``` +## Selenium + +sudo Xvfb :10 -ac -screen 0 1024x768x24 & +DISPLAY=:10 your-client ## ⚠️ Limitations This experiment aims to showcase the potential of GPT-4 but comes with some limitations: diff --git a/autogpt/__main__.py b/autogpt/__main__.py index e7ac6810b5..f90f1532cc 100644 --- a/autogpt/__main__.py +++ b/autogpt/__main__.py @@ -1,371 +1,20 @@ -import argparse -import json +"""Main script for the autogpt package.""" import logging -import traceback +from autogpt.agent.agent import Agent +from autogpt.args import parse_arguments -from colorama import Fore, Style +from autogpt.config import Config, check_openai_api_key +from autogpt.logs import logger +from autogpt.memory import get_memory -from autogpt import chat -from autogpt import commands as cmd -from autogpt import speak, utils -from autogpt.ai_config import AIConfig -from autogpt.config import Config -from autogpt.json_parser import fix_and_parse_json -from autogpt.logger import logger -from autogpt.memory import get_memory, get_supported_memory_backends -from autogpt.spinner import Spinner +from autogpt.prompt import construct_prompt -cfg = Config() -config = None +# Load environment variables from .env file -def check_openai_api_key(): - """Check if the OpenAI API key is set in config.py or as an environment variable.""" - if not cfg.openai_api_key: - print( - Fore.RED - + "Please set your OpenAI API key in .env or as an environment variable." - ) - print("You can get your key from https://beta.openai.com/account/api-keys") - exit(1) - - -def attempt_to_fix_json_by_finding_outermost_brackets(json_string): - if cfg.speak_mode and cfg.debug_mode: - speak.say_text( - "I have received an invalid JSON response from the OpenAI API. " - "Trying to fix it now." - ) - logger.typewriter_log("Attempting to fix JSON by finding outermost brackets\n") - - try: - # Use regex to search for JSON objects - import regex - - json_pattern = regex.compile(r"\{(?:[^{}]|(?R))*\}") - json_match = json_pattern.search(json_string) - - if json_match: - # Extract the valid JSON object from the string - json_string = json_match.group(0) - logger.typewriter_log( - title="Apparently json was fixed.", title_color=Fore.GREEN - ) - if cfg.speak_mode and cfg.debug_mode: - speak.say_text("Apparently json was fixed.") - else: - raise ValueError("No valid JSON object found") - - except (json.JSONDecodeError, ValueError) as e: - if cfg.debug_mode: - logger.error("Error: Invalid JSON: %s\n", json_string) - if cfg.speak_mode: - speak.say_text("Didn't work. I will have to ignore this response then.") - logger.error("Error: Invalid JSON, setting it to empty JSON now.\n") - json_string = {} - - return json_string - - -def print_assistant_thoughts(assistant_reply): - """Prints the assistant's thoughts to the console""" - global ai_name - global cfg - try: - try: - # Parse and print Assistant response - assistant_reply_json = fix_and_parse_json(assistant_reply) - except json.JSONDecodeError as e: - logger.error("Error: Invalid JSON in assistant thoughts\n", assistant_reply) - assistant_reply_json = attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply - ) - assistant_reply_json = fix_and_parse_json(assistant_reply_json) - - # Check if assistant_reply_json is a string and attempt to parse it into a - # JSON object - if isinstance(assistant_reply_json, str): - try: - assistant_reply_json = json.loads(assistant_reply_json) - except json.JSONDecodeError as e: - logger.error("Error: Invalid JSON\n", assistant_reply) - assistant_reply_json = ( - attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply_json - ) - ) - - assistant_thoughts_reasoning = None - assistant_thoughts_plan = None - assistant_thoughts_speak = None - assistant_thoughts_criticism = None - assistant_thoughts = assistant_reply_json.get("thoughts", {}) - assistant_thoughts_text = assistant_thoughts.get("text") - - if assistant_thoughts: - assistant_thoughts_reasoning = assistant_thoughts.get("reasoning") - assistant_thoughts_plan = assistant_thoughts.get("plan") - assistant_thoughts_criticism = assistant_thoughts.get("criticism") - assistant_thoughts_speak = assistant_thoughts.get("speak") - - logger.typewriter_log( - f"{ai_name.upper()} THOUGHTS:", Fore.YELLOW, f"{assistant_thoughts_text}" - ) - logger.typewriter_log( - "REASONING:", Fore.YELLOW, f"{assistant_thoughts_reasoning}" - ) - - if assistant_thoughts_plan: - logger.typewriter_log("PLAN:", Fore.YELLOW, "") - # If it's a list, join it into a string - if isinstance(assistant_thoughts_plan, list): - assistant_thoughts_plan = "\n".join(assistant_thoughts_plan) - elif isinstance(assistant_thoughts_plan, dict): - assistant_thoughts_plan = str(assistant_thoughts_plan) - - # Split the input_string using the newline character and dashes - lines = assistant_thoughts_plan.split("\n") - for line in lines: - line = line.lstrip("- ") - logger.typewriter_log("- ", Fore.GREEN, line.strip()) - - logger.typewriter_log( - "CRITICISM:", Fore.YELLOW, f"{assistant_thoughts_criticism}" - ) - # Speak the assistant's thoughts - if cfg.speak_mode and assistant_thoughts_speak: - speak.say_text(assistant_thoughts_speak) - - return assistant_reply_json - except json.decoder.JSONDecodeError: - call_stack = traceback.format_exc() - logger.error("Error: Invalid JSON\n", assistant_reply) - logger.error("Traceback: \n", call_stack) - if cfg.speak_mode: - speak.say_text( - "I have received an invalid JSON response from the OpenAI API." - " I cannot ignore this response." - ) - - # All other errors, return "Error: + error message" - except Exception: - call_stack = traceback.format_exc() - logger.error("Error: \n", call_stack) - - -def construct_prompt(): - """Construct the prompt for the AI to respond to""" - config: AIConfig = AIConfig.load(cfg.ai_settings_file) - if cfg.skip_reprompt and config.ai_name: - logger.typewriter_log("Name :", Fore.GREEN, config.ai_name) - logger.typewriter_log("Role :", Fore.GREEN, config.ai_role) - logger.typewriter_log("Goals:", Fore.GREEN, f"{config.ai_goals}") - elif config.ai_name: - logger.typewriter_log( - "Welcome back! ", - Fore.GREEN, - f"Would you like me to return to being {config.ai_name}?", - speak_text=True, - ) - should_continue = utils.clean_input( - f"""Continue with the last settings? -Name: {config.ai_name} -Role: {config.ai_role} -Goals: {config.ai_goals} -Continue (y/n): """ - ) - if should_continue.lower() == "n": - config = AIConfig() - - if not config.ai_name: - config = prompt_user() - config.save() - - # Get rid of this global: - global ai_name - ai_name = config.ai_name - - return config.construct_full_prompt() - - -def prompt_user(): - """Prompt the user for input""" - ai_name = "" - # Construct the prompt - logger.typewriter_log( - "Welcome to Auto-GPT! ", - Fore.GREEN, - "Enter the name of your AI and its role below. Entering nothing will load" - " defaults.", - speak_text=True, - ) - - # Get AI Name from User - logger.typewriter_log( - "Name your AI: ", Fore.GREEN, "For example, 'Entrepreneur-GPT'" - ) - ai_name = utils.clean_input("AI Name: ") - if ai_name == "": - ai_name = "Entrepreneur-GPT" - - logger.typewriter_log( - f"{ai_name} here!", Fore.LIGHTBLUE_EX, "I am at your service.", speak_text=True - ) - - # Get AI Role from User - logger.typewriter_log( - "Describe your AI's role: ", - Fore.GREEN, - "For example, 'an AI designed to autonomously develop and run businesses with" - " the sole goal of increasing your net worth.'", - ) - ai_role = utils.clean_input(f"{ai_name} is: ") - if ai_role == "": - ai_role = "an AI designed to autonomously develop and run businesses with the" - " sole goal of increasing your net worth." - - # Enter up to 5 goals for the AI - logger.typewriter_log( - "Enter up to 5 goals for your AI: ", - Fore.GREEN, - "For example: \nIncrease net worth, Grow Twitter Account, Develop and manage" - " multiple businesses autonomously'", - ) - print("Enter nothing to load defaults, enter nothing when finished.", flush=True) - ai_goals = [] - for i in range(5): - ai_goal = utils.clean_input(f"{Fore.LIGHTBLUE_EX}Goal{Style.RESET_ALL} {i+1}: ") - if ai_goal == "": - break - ai_goals.append(ai_goal) - if len(ai_goals) == 0: - ai_goals = [ - "Increase net worth", - "Grow Twitter Account", - "Develop and manage multiple businesses autonomously", - ] - - config = AIConfig(ai_name, ai_role, ai_goals) - return config - - -def parse_arguments(): - """Parses the arguments passed to the script""" - global cfg - cfg.set_debug_mode(False) - cfg.set_continuous_mode(False) - cfg.set_speak_mode(False) - - parser = argparse.ArgumentParser(description="Process arguments.") - parser.add_argument( - "--continuous", "-c", action="store_true", help="Enable Continuous Mode" - ) - parser.add_argument( - "--continuous-limit", - "-l", - type=int, - dest="continuous_limit", - help="Defines the number of times to run in continuous mode", - ) - parser.add_argument("--speak", action="store_true", help="Enable Speak Mode") - parser.add_argument("--debug", action="store_true", help="Enable Debug Mode") - parser.add_argument( - "--gpt3only", action="store_true", help="Enable GPT3.5 Only Mode" - ) - parser.add_argument("--gpt4only", action="store_true", help="Enable GPT4 Only Mode") - parser.add_argument( - "--use-memory", - "-m", - dest="memory_type", - help="Defines which Memory backend to use", - ) - parser.add_argument( - "--skip-reprompt", - "-y", - dest="skip_reprompt", - action="store_true", - help="Skips the re-prompting messages at the beginning of the script", - ) - parser.add_argument( - "--ai-settings", - "-C", - dest="ai_settings_file", - help="Specifies which ai_settings.yaml file to use, will also automatically" - " skip the re-prompt.", - ) - args = parser.parse_args() - - if args.debug: - logger.typewriter_log("Debug Mode: ", Fore.GREEN, "ENABLED") - cfg.set_debug_mode(True) - - if args.continuous: - logger.typewriter_log("Continuous Mode: ", Fore.RED, "ENABLED") - logger.typewriter_log( - "WARNING: ", - Fore.RED, - "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" - " authorise. Use at your own risk.", - ) - cfg.set_continuous_mode(True) - - if args.continuous_limit: - logger.typewriter_log( - "Continuous Limit: ", Fore.GREEN, f"{args.continuous_limit}" - ) - cfg.set_continuous_limit(args.continuous_limit) - - # Check if continuous limit is used without continuous mode - if args.continuous_limit and not args.continuous: - parser.error("--continuous-limit can only be used with --continuous") - - if args.speak: - logger.typewriter_log("Speak Mode: ", Fore.GREEN, "ENABLED") - cfg.set_speak_mode(True) - - if args.gpt3only: - logger.typewriter_log("GPT3.5 Only Mode: ", Fore.GREEN, "ENABLED") - cfg.set_smart_llm_model(cfg.fast_llm_model) - - if args.gpt4only: - logger.typewriter_log("GPT4 Only Mode: ", Fore.GREEN, "ENABLED") - cfg.set_fast_llm_model(cfg.smart_llm_model) - - if args.memory_type: - supported_memory = get_supported_memory_backends() - chosen = args.memory_type - if not chosen in supported_memory: - logger.typewriter_log( - "ONLY THE FOLLOWING MEMORY BACKENDS ARE SUPPORTED: ", - Fore.RED, - f"{supported_memory}", - ) - logger.typewriter_log("Defaulting to: ", Fore.YELLOW, cfg.memory_backend) - else: - cfg.memory_backend = chosen - - if args.skip_reprompt: - logger.typewriter_log("Skip Re-prompt: ", Fore.GREEN, "ENABLED") - cfg.skip_reprompt = True - - if args.ai_settings_file: - file = args.ai_settings_file - - # Validate file - (validated, message) = utils.validate_yaml_file(file) - if not validated: - logger.typewriter_log("FAILED FILE VALIDATION", Fore.RED, message) - logger.double_check() - exit(1) - - logger.typewriter_log("Using AI Settings File:", Fore.GREEN, file) - cfg.ai_settings_file = file - cfg.skip_reprompt = True - - -def main(): - global ai_name, memory +def main() -> None: + """Main function for the script""" + cfg = Config() # TODO: fill in llm values here check_openai_api_key() parse_arguments() @@ -396,177 +45,5 @@ def main(): agent.start_interaction_loop() -class Agent: - """Agent class for interacting with Auto-GPT. - - Attributes: - ai_name: The name of the agent. - memory: The memory object to use. - full_message_history: The full message history. - next_action_count: The number of actions to execute. - prompt: The prompt to use. - user_input: The user input. - - """ - - def __init__( - self, - ai_name, - memory, - full_message_history, - next_action_count, - prompt, - user_input, - ): - self.ai_name = ai_name - self.memory = memory - self.full_message_history = full_message_history - self.next_action_count = next_action_count - self.prompt = prompt - self.user_input = user_input - - def start_interaction_loop(self): - # Interaction Loop - loop_count = 0 - command_name = None - arguments = None - while True: - # Discontinue if continuous limit is reached - loop_count += 1 - if ( - cfg.continuous_mode - and cfg.continuous_limit > 0 - and loop_count > cfg.continuous_limit - ): - logger.typewriter_log( - "Continuous Limit Reached: ", Fore.YELLOW, f"{cfg.continuous_limit}" - ) - break - - # Send message to AI, get response - with Spinner("Thinking... "): - assistant_reply = chat.chat_with_ai( - self.prompt, - self.user_input, - self.full_message_history, - self.memory, - cfg.fast_token_limit, - ) # TODO: This hardcodes the model to use GPT3.5. Make this an argument - - # Print Assistant thoughts - print_assistant_thoughts(assistant_reply) - - # Get command name and arguments - try: - command_name, arguments = cmd.get_command( - attempt_to_fix_json_by_finding_outermost_brackets(assistant_reply) - ) - if cfg.speak_mode: - speak.say_text(f"I want to execute {command_name}") - except Exception as e: - logger.error("Error: \n", str(e)) - - if not cfg.continuous_mode and self.next_action_count == 0: - ### GET USER AUTHORIZATION TO EXECUTE COMMAND ### - # Get key press: Prompt the user to press enter to continue or escape - # to exit - self.user_input = "" - logger.typewriter_log( - "NEXT ACTION: ", - Fore.CYAN, - f"COMMAND = {Fore.CYAN}{command_name}{Style.RESET_ALL}" - f" ARGUMENTS = {Fore.CYAN}{arguments}{Style.RESET_ALL}", - ) - print( - "Enter 'y' to authorise command, 'y -N' to run N continuous" - " commands, 'n' to exit program, or enter feedback for" - f" {self.ai_name}...", - flush=True, - ) - while True: - console_input = utils.clean_input( - Fore.MAGENTA + "Input:" + Style.RESET_ALL - ) - if console_input.lower().rstrip() == "y": - self.user_input = "GENERATE NEXT COMMAND JSON" - break - elif console_input.lower().startswith("y -"): - try: - self.next_action_count = abs( - int(console_input.split(" ")[1]) - ) - self.user_input = "GENERATE NEXT COMMAND JSON" - except ValueError: - print( - "Invalid input format. Please enter 'y -n' where n" - " is the number of continuous tasks." - ) - continue - break - elif console_input.lower() == "n": - self.user_input = "EXIT" - break - else: - self.user_input = console_input - command_name = "human_feedback" - break - - if self.user_input == "GENERATE NEXT COMMAND JSON": - logger.typewriter_log( - "-=-=-=-=-=-=-= COMMAND AUTHORISED BY USER -=-=-=-=-=-=-=", - Fore.MAGENTA, - "", - ) - elif self.user_input == "EXIT": - print("Exiting...", flush=True) - break - else: - # Print command - logger.typewriter_log( - "NEXT ACTION: ", - Fore.CYAN, - f"COMMAND = {Fore.CYAN}{command_name}{Style.RESET_ALL}" - f" ARGUMENTS = {Fore.CYAN}{arguments}{Style.RESET_ALL}", - ) - - # Execute command - if command_name is not None and command_name.lower().startswith("error"): - result = ( - f"Command {command_name} threw the following error: {arguments}" - ) - elif command_name == "human_feedback": - result = f"Human feedback: {self.user_input}" - else: - result = ( - f"Command {command_name} " - f"returned: {cmd.execute_command(command_name, arguments)}" - ) - if self.next_action_count > 0: - self.next_action_count -= 1 - - memory_to_add = ( - f"Assistant Reply: {assistant_reply} " - f"\nResult: {result} " - f"\nHuman Feedback: {self.user_input} " - ) - - self.memory.add(memory_to_add) - - # Check if there's a result from the command append it to the message - # history - if result is not None: - self.full_message_history.append( - chat.create_chat_message("system", result) - ) - logger.typewriter_log("SYSTEM: ", Fore.YELLOW, result) - else: - self.full_message_history.append( - chat.create_chat_message("system", "Unable to execute command") - ) - logger.typewriter_log( - "SYSTEM: ", Fore.YELLOW, "Unable to execute command" - ) - - if __name__ == "__main__": main() diff --git a/autogpt/agent/__init__.py b/autogpt/agent/__init__.py new file mode 100644 index 0000000000..e928af2205 --- /dev/null +++ b/autogpt/agent/__init__.py @@ -0,0 +1,4 @@ +from autogpt.agent.agent import Agent +from autogpt.agent.agent_manager import AgentManager + +__all__ = ["Agent", "AgentManager"] diff --git a/autogpt/agent.py b/autogpt/agent/agent.py similarity index 56% rename from autogpt/agent.py rename to autogpt/agent/agent.py index 56c13d17c9..301d3f023e 100644 --- a/autogpt/agent.py +++ b/autogpt/agent/agent.py @@ -1,15 +1,13 @@ -import json -import regex -import traceback - from colorama import Fore, Style +from autogpt.app import execute_command, get_command from autogpt.chat import chat_with_ai, create_chat_message -import autogpt.commands as cmd from autogpt.config import Config -from autogpt.json_parser import fix_and_parse_json -from autogpt.logger import logger -from autogpt.speak import say_text +from autogpt.json_fixes.bracket_termination import ( + attempt_to_fix_json_by_finding_outermost_brackets, +) +from autogpt.logs import logger, print_assistant_thoughts +from autogpt.speech import say_text from autogpt.spinner import Spinner from autogpt.utils import clean_input @@ -77,7 +75,7 @@ class Agent: # Get command name and arguments try: - command_name, arguments = cmd.get_command( + command_name, arguments = get_command( attempt_to_fix_json_by_finding_outermost_brackets(assistant_reply) ) if cfg.speak_mode: @@ -158,7 +156,7 @@ class Agent: else: result = ( f"Command {command_name} returned: " - f"{cmd.execute_command(command_name, arguments)}" + f"{execute_command(command_name, arguments)}" ) if self.next_action_count > 0: self.next_action_count -= 1 @@ -183,122 +181,3 @@ class Agent: logger.typewriter_log( "SYSTEM: ", Fore.YELLOW, "Unable to execute command" ) - - -def attempt_to_fix_json_by_finding_outermost_brackets(json_string): - cfg = Config() - if cfg.speak_mode and cfg.debug_mode: - say_text( - "I have received an invalid JSON response from the OpenAI API. " - "Trying to fix it now." - ) - logger.typewriter_log("Attempting to fix JSON by finding outermost brackets\n") - - try: - json_pattern = regex.compile(r"\{(?:[^{}]|(?R))*\}") - json_match = json_pattern.search(json_string) - - if json_match: - # Extract the valid JSON object from the string - json_string = json_match.group(0) - logger.typewriter_log( - title="Apparently json was fixed.", title_color=Fore.GREEN - ) - if cfg.speak_mode and cfg.debug_mode: - say_text("Apparently json was fixed.") - else: - raise ValueError("No valid JSON object found") - - except (json.JSONDecodeError, ValueError): - if cfg.speak_mode: - say_text("Didn't work. I will have to ignore this response then.") - logger.error("Error: Invalid JSON, setting it to empty JSON now.\n") - json_string = {} - - return json_string - - -def print_assistant_thoughts(ai_name, assistant_reply): - """Prints the assistant's thoughts to the console""" - cfg = Config() - try: - try: - # Parse and print Assistant response - assistant_reply_json = fix_and_parse_json(assistant_reply) - except json.JSONDecodeError: - logger.error("Error: Invalid JSON in assistant thoughts\n", assistant_reply) - assistant_reply_json = attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply - ) - if isinstance(assistant_reply_json, str): - assistant_reply_json = fix_and_parse_json(assistant_reply_json) - - # Check if assistant_reply_json is a string and attempt to parse - # it into a JSON object - if isinstance(assistant_reply_json, str): - try: - assistant_reply_json = json.loads(assistant_reply_json) - except json.JSONDecodeError: - logger.error("Error: Invalid JSON\n", assistant_reply) - assistant_reply_json = ( - attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply_json - ) - ) - - assistant_thoughts_reasoning = None - assistant_thoughts_plan = None - assistant_thoughts_speak = None - assistant_thoughts_criticism = None - if not isinstance(assistant_reply_json, dict): - assistant_reply_json = {} - assistant_thoughts = assistant_reply_json.get("thoughts", {}) - assistant_thoughts_text = assistant_thoughts.get("text") - - if assistant_thoughts: - assistant_thoughts_reasoning = assistant_thoughts.get("reasoning") - assistant_thoughts_plan = assistant_thoughts.get("plan") - assistant_thoughts_criticism = assistant_thoughts.get("criticism") - assistant_thoughts_speak = assistant_thoughts.get("speak") - - logger.typewriter_log( - f"{ai_name.upper()} THOUGHTS:", Fore.YELLOW, f"{assistant_thoughts_text}" - ) - logger.typewriter_log( - "REASONING:", Fore.YELLOW, f"{assistant_thoughts_reasoning}" - ) - - if assistant_thoughts_plan: - logger.typewriter_log("PLAN:", Fore.YELLOW, "") - # If it's a list, join it into a string - if isinstance(assistant_thoughts_plan, list): - assistant_thoughts_plan = "\n".join(assistant_thoughts_plan) - elif isinstance(assistant_thoughts_plan, dict): - assistant_thoughts_plan = str(assistant_thoughts_plan) - - # Split the input_string using the newline character and dashes - lines = assistant_thoughts_plan.split("\n") - for line in lines: - line = line.lstrip("- ") - logger.typewriter_log("- ", Fore.GREEN, line.strip()) - - logger.typewriter_log( - "CRITICISM:", Fore.YELLOW, f"{assistant_thoughts_criticism}" - ) - # Speak the assistant's thoughts - if cfg.speak_mode and assistant_thoughts_speak: - say_text(assistant_thoughts_speak) - - return assistant_reply_json - except json.decoder.JSONDecodeError: - logger.error("Error: Invalid JSON\n", assistant_reply) - if cfg.speak_mode: - say_text( - "I have received an invalid JSON response from the OpenAI API." - " I cannot ignore this response." - ) - - # All other errors, return "Error: + error message" - except Exception: - call_stack = traceback.format_exc() - logger.error("Error: \n", call_stack) diff --git a/autogpt/agent/agent_manager.py b/autogpt/agent/agent_manager.py new file mode 100644 index 0000000000..a22adff38f --- /dev/null +++ b/autogpt/agent/agent_manager.py @@ -0,0 +1,100 @@ +"""Agent manager for managing GPT agents""" +from typing import List, Tuple, Union +from autogpt.llm_utils import create_chat_completion +from autogpt.config.config import Singleton + + +class AgentManager(metaclass=Singleton): + """Agent manager for managing GPT agents""" + + def __init__(self): + self.next_key = 0 + self.agents = {} # key, (task, full_message_history, model) + + # Create new GPT agent + # TODO: Centralise use of create_chat_completion() to globally enforce token limit + + def create_agent(self, task: str, prompt: str, model: str) -> tuple[int, str]: + """Create a new agent and return its key + + Args: + task: The task to perform + prompt: The prompt to use + model: The model to use + + Returns: + The key of the new agent + """ + messages = [ + {"role": "user", "content": prompt}, + ] + + # Start GPT instance + agent_reply = create_chat_completion( + model=model, + messages=messages, + ) + + # Update full message history + messages.append({"role": "assistant", "content": agent_reply}) + + key = self.next_key + # This is done instead of len(agents) to make keys unique even if agents + # are deleted + self.next_key += 1 + + self.agents[key] = (task, messages, model) + + return key, agent_reply + + def message_agent(self, key: Union[str, int], message: str) -> str: + """Send a message to an agent and return its response + + Args: + key: The key of the agent to message + message: The message to send to the agent + + Returns: + The agent's response + """ + task, messages, model = self.agents[int(key)] + + # Add user message to message history before sending to agent + messages.append({"role": "user", "content": message}) + + # Start GPT instance + agent_reply = create_chat_completion( + model=model, + messages=messages, + ) + + # Update full message history + messages.append({"role": "assistant", "content": agent_reply}) + + return agent_reply + + def list_agents(self) -> List[Tuple[Union[str, int], str]]: + """Return a list of all agents + + Returns: + A list of tuples of the form (key, task) + """ + + # Return a list of agent keys and their tasks + return [(key, task) for key, (task, _, _) in self.agents.items()] + + def delete_agent(self, key: Union[str, int]) -> bool: + """Delete an agent from the agent manager + + Args: + key: The key of the agent to delete + + Returns: + True if successful, False otherwise + """ + + try: + del self.agents[int(key)] + return True + except KeyError: + return False diff --git a/autogpt/agent_manager.py b/autogpt/agent_manager.py deleted file mode 100644 index bbf156eed2..0000000000 --- a/autogpt/agent_manager.py +++ /dev/null @@ -1,75 +0,0 @@ -from autogpt.llm_utils import create_chat_completion - -next_key = 0 -agents = {} # key, (task, full_message_history, model) - -# Create new GPT agent -# TODO: Centralise use of create_chat_completion() to globally enforce token limit - - -def create_agent(task, prompt, model): - """Create a new agent and return its key""" - global next_key - global agents - - messages = [ - {"role": "user", "content": prompt}, - ] - - # Start GPT instance - agent_reply = create_chat_completion( - model=model, - messages=messages, - ) - - # Update full message history - messages.append({"role": "assistant", "content": agent_reply}) - - key = next_key - # This is done instead of len(agents) to make keys unique even if agents - # are deleted - next_key += 1 - - agents[key] = (task, messages, model) - - return key, agent_reply - - -def message_agent(key, message): - """Send a message to an agent and return its response""" - global agents - - task, messages, model = agents[int(key)] - - # Add user message to message history before sending to agent - messages.append({"role": "user", "content": message}) - - # Start GPT instance - agent_reply = create_chat_completion( - model=model, - messages=messages, - ) - - # Update full message history - messages.append({"role": "assistant", "content": agent_reply}) - - return agent_reply - - -def list_agents(): - """Return a list of all agents""" - global agents - - # Return a list of agent keys and their tasks - return [(key, task) for key, (task, _, _) in agents.items()] - - -def delete_agent(key): - """Delete an agent and return True if successful, False otherwise""" - global agents - - try: - del agents[int(key)] - return True - except KeyError: - return False diff --git a/autogpt/ai_functions.py b/autogpt/ai_functions.py deleted file mode 100644 index 84f8268582..0000000000 --- a/autogpt/ai_functions.py +++ /dev/null @@ -1,77 +0,0 @@ -import json -from typing import List - -from autogpt.call_ai_function import call_ai_function -from autogpt.config import Config - -cfg = Config() - - -def evaluate_code(code: str) -> List[str]: - """ - A function that takes in a string and returns a response from create chat - completion api call. - - Parameters: - code (str): Code to be evaluated. - Returns: - A result string from create chat completion. A list of suggestions to - improve the code. - """ - - function_string = "def analyze_code(code: str) -> List[str]:" - args = [code] - description_string = ( - "Analyzes the given code and returns a list of suggestions" " for improvements." - ) - - return call_ai_function(function_string, args, description_string) - - -def improve_code(suggestions: List[str], code: str) -> str: - """ - A function that takes in code and suggestions and returns a response from create - chat completion api call. - - Parameters: - suggestions (List): A list of suggestions around what needs to be improved. - code (str): Code to be improved. - Returns: - A result string from create chat completion. Improved code in response. - """ - - function_string = ( - "def generate_improved_code(suggestions: List[str], code: str) -> str:" - ) - args = [json.dumps(suggestions), code] - description_string = ( - "Improves the provided code based on the suggestions" - " provided, making no other changes." - ) - - return call_ai_function(function_string, args, description_string) - - -def write_tests(code: str, focus: List[str]) -> str: - """ - A function that takes in code and focus topics and returns a response from create - chat completion api call. - - Parameters: - focus (List): A list of suggestions around what needs to be improved. - code (str): Code for test cases to be generated against. - Returns: - A result string from create chat completion. Test cases for the submitted code - in response. - """ - - function_string = ( - "def create_test_cases(code: str, focus: Optional[str] = None) -> str:" - ) - args = [code, json.dumps(focus)] - description_string = ( - "Generates test cases for the existing code, focusing on" - " specific areas if required." - ) - - return call_ai_function(function_string, args, description_string) diff --git a/autogpt/commands.py b/autogpt/app.py similarity index 61% rename from autogpt/commands.py rename to autogpt/app.py index 352b3340ba..0adfde5d5b 100644 --- a/autogpt/commands.py +++ b/autogpt/app.py @@ -1,29 +1,42 @@ +""" Command and Control """ import json -import datetime -import autogpt.agent_manager as agents +from typing import List, NoReturn, Union +from autogpt.agent.agent_manager import AgentManager +from autogpt.commands.evaluate_code import evaluate_code +from autogpt.commands.google_search import google_official_search, google_search +from autogpt.commands.improve_code import improve_code +from autogpt.commands.write_tests import write_tests from autogpt.config import Config -from autogpt.json_parser import fix_and_parse_json -from autogpt.image_gen import generate_image -from duckduckgo_search import ddg -from autogpt.ai_functions import evaluate_code, improve_code, write_tests -from autogpt.browse import scrape_links, scrape_text, summarize_text -from autogpt.execute_code import execute_python_file, execute_shell -from autogpt.file_operations import ( +from autogpt.commands.image_gen import generate_image +from autogpt.commands.web_requests import scrape_links, scrape_text +from autogpt.commands.execute_code import execute_python_file, execute_shell +from autogpt.commands.file_operations import ( append_to_file, delete_file, read_file, search_files, write_to_file, ) +from autogpt.json_fixes.parsing import fix_and_parse_json from autogpt.memory import get_memory -from autogpt.speak import say_text -from autogpt.web import browse_website +from autogpt.processing.text import summarize_text +from autogpt.speech import say_text +from autogpt.commands.web_selenium import browse_website -cfg = Config() +CFG = Config() +AGENT_MANAGER = AgentManager() -def is_valid_int(value) -> bool: +def is_valid_int(value: str) -> bool: + """Check if the value is a valid integer + + Args: + value (str): The value to check + + Returns: + bool: True if the value is a valid integer, False otherwise + """ try: int(value) return True @@ -31,8 +44,20 @@ def is_valid_int(value) -> bool: return False -def get_command(response): - """Parse the response and return the command name and arguments""" +def get_command(response: str): + """Parse the response and return the command name and arguments + + Args: + response (str): The response from the user + + Returns: + tuple: The command name and arguments + + Raises: + json.decoder.JSONDecodeError: If the response is not valid JSON + + Exception: If any other error occurs + """ try: response_json = fix_and_parse_json(response) @@ -62,16 +87,23 @@ def get_command(response): return "Error:", str(e) -def execute_command(command_name, arguments): - """Execute the command and return the result""" - memory = get_memory(cfg) +def execute_command(command_name: str, arguments): + """Execute the command and return the result + + Args: + command_name (str): The name of the command to execute + arguments (dict): The arguments for the command + + Returns: + str: The result of the command""" + memory = get_memory(CFG) try: if command_name == "google": # Check if the Google API key is set and use the official search method # If the API key is not set or has only whitespaces, use the unofficial # search method - key = cfg.google_api_key + key = CFG.google_api_key if key and key.strip() and key != "your-google-api-key": return google_official_search(arguments["input"]) else: @@ -116,7 +148,7 @@ def execute_command(command_name, arguments): elif command_name == "execute_python_file": # Add this command return execute_python_file(arguments["file"]) elif command_name == "execute_shell": - if cfg.execute_local_commands: + if CFG.execute_local_commands: return execute_shell(arguments["command_line"]) else: return ( @@ -136,96 +168,55 @@ def execute_command(command_name, arguments): " list for available commands and only respond in the specified JSON" " format." ) - # All errors, return "Error: + error message" except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def get_datetime(): - """Return the current date and time""" - return "Current date and time: " + datetime.datetime.now().strftime( - "%Y-%m-%d %H:%M:%S" - ) +def get_text_summary(url: str, question: str) -> str: + """Return the results of a google search + Args: + url (str): The url to scrape + question (str): The question to summarize the text for -def google_search(query, num_results=8): - """Return the results of a google search""" - search_results = [] - if not query: - return json.dumps(search_results) - - for j in ddg(query, max_results=num_results): - search_results.append(j) - - return json.dumps(search_results, ensure_ascii=False, indent=4) - - -def google_official_search(query, num_results=8): - """Return the results of a google search using the official Google API""" - import json - - from googleapiclient.discovery import build - from googleapiclient.errors import HttpError - - try: - # Get the Google API key and Custom Search Engine ID from the config file - api_key = cfg.google_api_key - custom_search_engine_id = cfg.custom_search_engine_id - - # Initialize the Custom Search API service - service = build("customsearch", "v1", developerKey=api_key) - - # Send the search query and retrieve the results - result = ( - service.cse() - .list(q=query, cx=custom_search_engine_id, num=num_results) - .execute() - ) - - # Extract the search result items from the response - search_results = result.get("items", []) - - # Create a list of only the URLs from the search results - search_results_links = [item["link"] for item in search_results] - - except HttpError as e: - # Handle errors in the API call - error_details = json.loads(e.content.decode()) - - # Check if the error is related to an invalid or missing API key - if error_details.get("error", {}).get( - "code" - ) == 403 and "invalid API key" in error_details.get("error", {}).get( - "message", "" - ): - return "Error: The provided Google API key is invalid or missing." - else: - return f"Error: {e}" - - # Return the list of search result URLs - return search_results_links - - -def get_text_summary(url, question): - """Return the results of a google search""" + Returns: + str: The summary of the text + """ text = scrape_text(url) summary = summarize_text(url, text, question) - return """ "Result" : """ + summary + return f""" "Result" : {summary}""" -def get_hyperlinks(url): - """Return the results of a google search""" +def get_hyperlinks(url: str) -> Union[str, List[str]]: + """Return the results of a google search + + Args: + url (str): The url to scrape + + Returns: + str or list: The hyperlinks on the page + """ return scrape_links(url) -def shutdown(): +def shutdown() -> NoReturn: """Shut down the program""" print("Shutting down...") quit() -def start_agent(name, task, prompt, model=cfg.fast_llm_model): - """Start an agent with a given name, task, and prompt""" +def start_agent(name: str, task: str, prompt: str, model=CFG.fast_llm_model) -> str: + """Start an agent with a given name, task, and prompt + + Args: + name (str): The name of the agent + task (str): The task of the agent + prompt (str): The prompt for the agent + model (str): The model to use for the agent + + Returns: + str: The response of the agent + """ # Remove underscores from name voice_name = name.replace("_", " ") @@ -233,42 +224,53 @@ def start_agent(name, task, prompt, model=cfg.fast_llm_model): agent_intro = f"{voice_name} here, Reporting for duty!" # Create agent - if cfg.speak_mode: + if CFG.speak_mode: say_text(agent_intro, 1) - key, ack = agents.create_agent(task, first_message, model) + key, ack = AGENT_MANAGER.create_agent(task, first_message, model) - if cfg.speak_mode: + if CFG.speak_mode: say_text(f"Hello {voice_name}. Your task is as follows. {task}.") # Assign task (prompt), get response - agent_response = agents.message_agent(key, prompt) + agent_response = AGENT_MANAGER.message_agent(key, prompt) return f"Agent {name} created with key {key}. First response: {agent_response}" -def message_agent(key, message): +def message_agent(key: str, message: str) -> str: """Message an agent with a given key and message""" # Check if the key is a valid integer if is_valid_int(key): - agent_response = agents.message_agent(int(key), message) + agent_response = AGENT_MANAGER.message_agent(int(key), message) # Check if the key is a valid string elif isinstance(key, str): - agent_response = agents.message_agent(key, message) + agent_response = AGENT_MANAGER.message_agent(key, message) else: return "Invalid key, must be an integer or a string." # Speak response - if cfg.speak_mode: + if CFG.speak_mode: say_text(agent_response, 1) return agent_response def list_agents(): - """List all agents""" - return list_agents() + """List all agents + + Returns: + list: A list of all agents + """ + return AGENT_MANAGER.list_agents() -def delete_agent(key): - """Delete an agent with a given key""" - result = agents.delete_agent(key) +def delete_agent(key: str) -> str: + """Delete an agent with a given key + + Args: + key (str): The key of the agent to delete + + Returns: + str: A message indicating whether the agent was deleted or not + """ + result = AGENT_MANAGER.delete_agent(key) return f"Agent {key} deleted." if result else f"Agent {key} does not exist." diff --git a/autogpt/args.py b/autogpt/args.py new file mode 100644 index 0000000000..6c907a1f6a --- /dev/null +++ b/autogpt/args.py @@ -0,0 +1,128 @@ +"""This module contains the argument parsing logic for the script.""" +import argparse + +from colorama import Fore +from autogpt import utils +from autogpt.config import Config +from autogpt.logs import logger +from autogpt.memory import get_supported_memory_backends + +CFG = Config() + + +def parse_arguments() -> None: + """Parses the arguments passed to the script + + Returns: + None + """ + CFG.set_debug_mode(False) + CFG.set_continuous_mode(False) + CFG.set_speak_mode(False) + + parser = argparse.ArgumentParser(description="Process arguments.") + parser.add_argument( + "--continuous", "-c", action="store_true", help="Enable Continuous Mode" + ) + parser.add_argument( + "--continuous-limit", + "-l", + type=int, + dest="continuous_limit", + help="Defines the number of times to run in continuous mode", + ) + parser.add_argument("--speak", action="store_true", help="Enable Speak Mode") + parser.add_argument("--debug", action="store_true", help="Enable Debug Mode") + parser.add_argument( + "--gpt3only", action="store_true", help="Enable GPT3.5 Only Mode" + ) + parser.add_argument("--gpt4only", action="store_true", help="Enable GPT4 Only Mode") + parser.add_argument( + "--use-memory", + "-m", + dest="memory_type", + help="Defines which Memory backend to use", + ) + parser.add_argument( + "--skip-reprompt", + "-y", + dest="skip_reprompt", + action="store_true", + help="Skips the re-prompting messages at the beginning of the script", + ) + parser.add_argument( + "--ai-settings", + "-C", + dest="ai_settings_file", + help="Specifies which ai_settings.yaml file to use, will also automatically" + " skip the re-prompt.", + ) + args = parser.parse_args() + + if args.debug: + logger.typewriter_log("Debug Mode: ", Fore.GREEN, "ENABLED") + CFG.set_debug_mode(True) + + if args.continuous: + logger.typewriter_log("Continuous Mode: ", Fore.RED, "ENABLED") + logger.typewriter_log( + "WARNING: ", + Fore.RED, + "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" + " authorise. Use at your own risk.", + ) + CFG.set_continuous_mode(True) + + if args.continuous_limit: + logger.typewriter_log( + "Continuous Limit: ", Fore.GREEN, f"{args.continuous_limit}" + ) + CFG.set_continuous_limit(args.continuous_limit) + + # Check if continuous limit is used without continuous mode + if args.continuous_limit and not args.continuous: + parser.error("--continuous-limit can only be used with --continuous") + + if args.speak: + logger.typewriter_log("Speak Mode: ", Fore.GREEN, "ENABLED") + CFG.set_speak_mode(True) + + if args.gpt3only: + logger.typewriter_log("GPT3.5 Only Mode: ", Fore.GREEN, "ENABLED") + CFG.set_smart_llm_model(CFG.fast_llm_model) + + if args.gpt4only: + logger.typewriter_log("GPT4 Only Mode: ", Fore.GREEN, "ENABLED") + CFG.set_fast_llm_model(CFG.smart_llm_model) + + if args.memory_type: + supported_memory = get_supported_memory_backends() + chosen = args.memory_type + if chosen not in supported_memory: + logger.typewriter_log( + "ONLY THE FOLLOWING MEMORY BACKENDS ARE SUPPORTED: ", + Fore.RED, + f"{supported_memory}", + ) + logger.typewriter_log("Defaulting to: ", Fore.YELLOW, CFG.memory_backend) + else: + CFG.memory_backend = chosen + + if args.skip_reprompt: + logger.typewriter_log("Skip Re-prompt: ", Fore.GREEN, "ENABLED") + CFG.skip_reprompt = True + + if args.ai_settings_file: + file = args.ai_settings_file + + # Validate file + (validated, message) = utils.validate_yaml_file(file) + if not validated: + logger.typewriter_log("FAILED FILE VALIDATION", Fore.RED, message) + logger.double_check() + exit(1) + + logger.typewriter_log("Using AI Settings File:", Fore.GREEN, file) + CFG.ai_settings_file = file + CFG.skip_reprompt = True diff --git a/autogpt/call_ai_function.py b/autogpt/call_ai_function.py deleted file mode 100644 index bbbd8e3531..0000000000 --- a/autogpt/call_ai_function.py +++ /dev/null @@ -1,26 +0,0 @@ -from autogpt.config import Config -from autogpt.llm_utils import create_chat_completion - -cfg = Config() - - -# This is a magic function that can do anything with no-code. See -# https://github.com/Torantulino/AI-Functions for more info. -def call_ai_function(function, args, description, model=None) -> str: - """Call an AI function""" - if model is None: - model = cfg.smart_llm_model - # For each arg, if any are None, convert to "None": - args = [str(arg) if arg is not None else "None" for arg in args] - # parse args to comma separated string - args = ", ".join(args) - messages = [ - { - "role": "system", - "content": f"You are now the following python function: ```# {description}" - f"\n{function}```\n\nOnly respond with your `return` value.", - }, - {"role": "user", "content": args}, - ] - - return create_chat_completion(model=model, messages=messages, temperature=0) diff --git a/autogpt/chat.py b/autogpt/chat.py index 12797d9f0c..b08869679d 100644 --- a/autogpt/chat.py +++ b/autogpt/chat.py @@ -5,7 +5,7 @@ from openai.error import RateLimitError from autogpt import token_counter from autogpt.config import Config from autogpt.llm_utils import create_chat_completion -from autogpt.logger import logger +from autogpt.logs import logger cfg = Config() diff --git a/autogpt/commands/__init__.py b/autogpt/commands/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/autogpt/commands/evaluate_code.py b/autogpt/commands/evaluate_code.py new file mode 100644 index 0000000000..a36952e5e0 --- /dev/null +++ b/autogpt/commands/evaluate_code.py @@ -0,0 +1,25 @@ +"""Code evaluation module.""" +from typing import List + +from autogpt.llm_utils import call_ai_function + + +def evaluate_code(code: str) -> List[str]: + """ + A function that takes in a string and returns a response from create chat + completion api call. + + Parameters: + code (str): Code to be evaluated. + Returns: + A result string from create chat completion. A list of suggestions to + improve the code. + """ + + function_string = "def analyze_code(code: str) -> List[str]:" + args = [code] + description_string = ( + "Analyzes the given code and returns a list of suggestions" " for improvements." + ) + + return call_ai_function(function_string, args, description_string) diff --git a/autogpt/commands/execute_code.py b/autogpt/commands/execute_code.py new file mode 100644 index 0000000000..db33490cc9 --- /dev/null +++ b/autogpt/commands/execute_code.py @@ -0,0 +1,125 @@ +"""Execute code in a Docker container""" +import os +from pathlib import Path +import subprocess + +import docker +from docker.errors import ImageNotFound + +WORKING_DIRECTORY = Path(__file__).parent.parent / "auto_gpt_workspace" + + +def execute_python_file(file: str): + """Execute a Python file in a Docker container and return the output + + Args: + file (str): The name of the file to execute + + Returns: + str: The output of the file + """ + + print(f"Executing file '{file}' in workspace '{WORKING_DIRECTORY}'") + + if not file.endswith(".py"): + return "Error: Invalid file type. Only .py files are allowed." + + file_path = os.path.join(WORKING_DIRECTORY, file) + + if not os.path.isfile(file_path): + return f"Error: File '{file}' does not exist." + + if we_are_running_in_a_docker_container(): + result = subprocess.run( + f"python {file_path}", capture_output=True, encoding="utf8", shell=True + ) + if result.returncode == 0: + return result.stdout + else: + return f"Error: {result.stderr}" + + try: + client = docker.from_env() + + image_name = "python:3.10" + try: + client.images.get(image_name) + print(f"Image '{image_name}' found locally") + except ImageNotFound: + print(f"Image '{image_name}' not found locally, pulling from Docker Hub") + # Use the low-level API to stream the pull response + low_level_client = docker.APIClient() + for line in low_level_client.pull(image_name, stream=True, decode=True): + # Print the status and progress, if available + status = line.get("status") + progress = line.get("progress") + if status and progress: + print(f"{status}: {progress}") + elif status: + print(status) + + # You can replace 'python:3.8' with the desired Python image/version + # You can find available Python images on Docker Hub: + # https://hub.docker.com/_/python + container = client.containers.run( + image_name, + f"python {file}", + volumes={ + os.path.abspath(WORKING_DIRECTORY): { + "bind": "/workspace", + "mode": "ro", + } + }, + working_dir="/workspace", + stderr=True, + stdout=True, + detach=True, + ) + + container.wait() + logs = container.logs().decode("utf-8") + container.remove() + + # print(f"Execution complete. Output: {output}") + # print(f"Logs: {logs}") + + return logs + + except Exception as e: + return f"Error: {str(e)}" + + +def execute_shell(command_line: str) -> str: + """Execute a shell command and return the output + + Args: + command_line (str): The command line to execute + + Returns: + str: The output of the command + """ + current_dir = os.getcwd() + + if WORKING_DIRECTORY not in current_dir: # Change dir into workspace if necessary + work_dir = os.path.join(os.getcwd(), WORKING_DIRECTORY) + os.chdir(work_dir) + + print(f"Executing command '{command_line}' in working directory '{os.getcwd()}'") + + result = subprocess.run(command_line, capture_output=True, shell=True) + output = f"STDOUT:\n{result.stdout}\nSTDERR:\n{result.stderr}" + + # Change back to whatever the prior working dir was + + os.chdir(current_dir) + + return output + + +def we_are_running_in_a_docker_container() -> bool: + """Check if we are running in a Docker container + + Returns: + bool: True if we are running in a Docker container, False otherwise + """ + return os.path.exists("/.dockerenv") diff --git a/autogpt/file_operations.py b/autogpt/commands/file_operations.py similarity index 58% rename from autogpt/file_operations.py rename to autogpt/commands/file_operations.py index 1c8f9290cd..9d11a878bb 100644 --- a/autogpt/file_operations.py +++ b/autogpt/commands/file_operations.py @@ -1,16 +1,29 @@ +"""File operations for AutoGPT""" import os import os.path +from pathlib import Path +from typing import Generator, List # Set a dedicated folder for file I/O -working_directory = "auto_gpt_workspace" +WORKING_DIRECTORY = Path(__file__).parent.parent / "auto_gpt_workspace" # Create the directory if it doesn't exist -if not os.path.exists(working_directory): - os.makedirs(working_directory) +if not os.path.exists(WORKING_DIRECTORY): + os.makedirs(WORKING_DIRECTORY) + +WORKING_DIRECTORY = str(WORKING_DIRECTORY) -def safe_join(base, *paths): - """Join one or more path components intelligently.""" +def safe_join(base: str, *paths) -> str: + """Join one or more path components intelligently. + + Args: + base (str): The base path + *paths (str): The paths to join to the base path + + Returns: + str: The joined path + """ new_path = os.path.join(base, *paths) norm_new_path = os.path.normpath(new_path) @@ -20,7 +33,9 @@ def safe_join(base, *paths): return norm_new_path -def split_file(content, max_length=4000, overlap=0): +def split_file( + content: str, max_length: int = 4000, overlap: int = 0 +) -> Generator[str, None, None]: """ Split text into chunks of a specified maximum length with a specified overlap between chunks. @@ -45,10 +60,17 @@ def split_file(content, max_length=4000, overlap=0): start += max_length - overlap -def read_file(filename) -> str: - """Read a file and return the contents""" +def read_file(filename: str) -> str: + """Read a file and return the contents + + Args: + filename (str): The name of the file to read + + Returns: + str: The contents of the file + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) with open(filepath, "r", encoding="utf-8") as f: content = f.read() return content @@ -56,7 +78,9 @@ def read_file(filename) -> str: return f"Error: {str(e)}" -def ingest_file(filename, memory, max_length=4000, overlap=200): +def ingest_file( + filename: str, memory, max_length: int = 4000, overlap: int = 200 +) -> None: """ Ingest a file by reading its content, splitting it into chunks with a specified maximum length and overlap, and adding the chunks to the memory storage. @@ -88,10 +112,18 @@ def ingest_file(filename, memory, max_length=4000, overlap=200): print(f"Error while ingesting file '{filename}': {str(e)}") -def write_to_file(filename, text): - """Write text to a file""" +def write_to_file(filename: str, text: str) -> str: + """Write text to a file + + Args: + filename (str): The name of the file to write to + text (str): The text to write to the file + + Returns: + str: A message indicating success or failure + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) directory = os.path.dirname(filepath) if not os.path.exists(directory): os.makedirs(directory) @@ -99,43 +131,66 @@ def write_to_file(filename, text): f.write(text) return "File written to successfully." except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def append_to_file(filename, text): - """Append text to a file""" +def append_to_file(filename: str, text: str) -> str: + """Append text to a file + + Args: + filename (str): The name of the file to append to + text (str): The text to append to the file + + Returns: + str: A message indicating success or failure + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) with open(filepath, "a") as f: f.write(text) return "Text appended successfully." except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def delete_file(filename): - """Delete a file""" +def delete_file(filename: str) -> str: + """Delete a file + + Args: + filename (str): The name of the file to delete + + Returns: + str: A message indicating success or failure + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) os.remove(filepath) return "File deleted successfully." except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def search_files(directory): +def search_files(directory: str) -> List[str]: + """Search for files in a directory + + Args: + directory (str): The directory to search in + + Returns: + List[str]: A list of files found in the directory + """ found_files = [] - if directory == "" or directory == "/": - search_directory = working_directory + if directory in {"", "/"}: + search_directory = WORKING_DIRECTORY else: - search_directory = safe_join(working_directory, directory) + search_directory = safe_join(WORKING_DIRECTORY, directory) for root, _, files in os.walk(search_directory): for file in files: if file.startswith("."): continue - relative_path = os.path.relpath(os.path.join(root, file), working_directory) + relative_path = os.path.relpath(os.path.join(root, file), WORKING_DIRECTORY) found_files.append(relative_path) return found_files diff --git a/autogpt/commands/google_search.py b/autogpt/commands/google_search.py new file mode 100644 index 0000000000..6deb9b5033 --- /dev/null +++ b/autogpt/commands/google_search.py @@ -0,0 +1,86 @@ +"""Google search command for Autogpt.""" +import json +from typing import List, Union + +from duckduckgo_search import ddg + +from autogpt.config import Config + +CFG = Config() + + +def google_search(query: str, num_results: int = 8) -> str: + """Return the results of a google search + + Args: + query (str): The search query. + num_results (int): The number of results to return. + + Returns: + str: The results of the search. + """ + search_results = [] + if not query: + return json.dumps(search_results) + + results = ddg(query, max_results=num_results) + if not results: + return json.dumps(search_results) + + for j in results: + search_results.append(j) + + return json.dumps(search_results, ensure_ascii=False, indent=4) + + +def google_official_search(query: str, num_results: int = 8) -> Union[str, List[str]]: + """Return the results of a google search using the official Google API + + Args: + query (str): The search query. + num_results (int): The number of results to return. + + Returns: + str: The results of the search. + """ + + from googleapiclient.discovery import build + from googleapiclient.errors import HttpError + + try: + # Get the Google API key and Custom Search Engine ID from the config file + api_key = CFG.google_api_key + custom_search_engine_id = CFG.custom_search_engine_id + + # Initialize the Custom Search API service + service = build("customsearch", "v1", developerKey=api_key) + + # Send the search query and retrieve the results + result = ( + service.cse() + .list(q=query, cx=custom_search_engine_id, num=num_results) + .execute() + ) + + # Extract the search result items from the response + search_results = result.get("items", []) + + # Create a list of only the URLs from the search results + search_results_links = [item["link"] for item in search_results] + + except HttpError as e: + # Handle errors in the API call + error_details = json.loads(e.content.decode()) + + # Check if the error is related to an invalid or missing API key + if error_details.get("error", {}).get( + "code" + ) == 403 and "invalid API key" in error_details.get("error", {}).get( + "message", "" + ): + return "Error: The provided Google API key is invalid or missing." + else: + return f"Error: {e}" + + # Return the list of search result URLs + return search_results_links diff --git a/autogpt/commands/image_gen.py b/autogpt/commands/image_gen.py new file mode 100644 index 0000000000..39e08845a6 --- /dev/null +++ b/autogpt/commands/image_gen.py @@ -0,0 +1,99 @@ +""" Image Generation Module for AutoGPT.""" +import io +import os.path +import uuid +from base64 import b64decode + +import openai +import requests +from PIL import Image +from pathlib import Path +from autogpt.config import Config + +CFG = Config() + +WORKING_DIRECTORY = Path(__file__).parent.parent / "auto_gpt_workspace" + + +def generate_image(prompt: str) -> str: + """Generate an image from a prompt. + + Args: + prompt (str): The prompt to use + + Returns: + str: The filename of the image + """ + filename = f"{str(uuid.uuid4())}.jpg" + + # DALL-E + if CFG.image_provider == "dalle": + return generate_image_with_dalle(prompt, filename) + elif CFG.image_provider == "sd": + return generate_image_with_hf(prompt, filename) + else: + return "No Image Provider Set" + + +def generate_image_with_hf(prompt: str, filename: str) -> str: + """Generate an image with HuggingFace's API. + + Args: + prompt (str): The prompt to use + filename (str): The filename to save the image to + + Returns: + str: The filename of the image + """ + API_URL = ( + "https://api-inference.huggingface.co/models/CompVis/stable-diffusion-v1-4" + ) + if CFG.huggingface_api_token is None: + raise ValueError( + "You need to set your Hugging Face API token in the config file." + ) + headers = {"Authorization": f"Bearer {CFG.huggingface_api_token}"} + + response = requests.post( + API_URL, + headers=headers, + json={ + "inputs": prompt, + }, + ) + + image = Image.open(io.BytesIO(response.content)) + print(f"Image Generated for prompt:{prompt}") + + image.save(os.path.join(WORKING_DIRECTORY, filename)) + + return f"Saved to disk:{filename}" + + +def generate_image_with_dalle(prompt: str, filename: str) -> str: + """Generate an image with DALL-E. + + Args: + prompt (str): The prompt to use + filename (str): The filename to save the image to + + Returns: + str: The filename of the image + """ + openai.api_key = CFG.openai_api_key + + response = openai.Image.create( + prompt=prompt, + n=1, + size="256x256", + response_format="b64_json", + ) + + print(f"Image Generated for prompt:{prompt}") + + image_data = b64decode(response["data"][0]["b64_json"]) + + with open(f"{WORKING_DIRECTORY}/{filename}", mode="wb") as png: + png.write(image_data) + + return f"Saved to disk:{filename}" diff --git a/autogpt/commands/improve_code.py b/autogpt/commands/improve_code.py new file mode 100644 index 0000000000..05fe89e9ed --- /dev/null +++ b/autogpt/commands/improve_code.py @@ -0,0 +1,28 @@ +import json +from typing import List + +from autogpt.llm_utils import call_ai_function + + +def improve_code(suggestions: List[str], code: str) -> str: + """ + A function that takes in code and suggestions and returns a response from create + chat completion api call. + + Parameters: + suggestions (List): A list of suggestions around what needs to be improved. + code (str): Code to be improved. + Returns: + A result string from create chat completion. Improved code in response. + """ + + function_string = ( + "def generate_improved_code(suggestions: List[str], code: str) -> str:" + ) + args = [json.dumps(suggestions), code] + description_string = ( + "Improves the provided code based on the suggestions" + " provided, making no other changes." + ) + + return call_ai_function(function_string, args, description_string) diff --git a/autogpt/commands/times.py b/autogpt/commands/times.py new file mode 100644 index 0000000000..3c9b8a4fc6 --- /dev/null +++ b/autogpt/commands/times.py @@ -0,0 +1,10 @@ +from datetime import datetime + + +def get_datetime() -> str: + """Return the current date and time + + Returns: + str: The current date and time + """ + return "Current date and time: " + datetime.now().strftime("%Y-%m-%d %H:%M:%S") diff --git a/autogpt/browse.py b/autogpt/commands/web_requests.py similarity index 51% rename from autogpt/browse.py rename to autogpt/commands/web_requests.py index 60d337443e..59c3e5229f 100644 --- a/autogpt/browse.py +++ b/autogpt/commands/web_requests.py @@ -1,21 +1,30 @@ +"""Browse a webpage and summarize it using the LLM model""" +from typing import List, Tuple, Union from urllib.parse import urljoin, urlparse import requests +from requests import Response from bs4 import BeautifulSoup from autogpt.config import Config -from autogpt.llm_utils import create_chat_completion from autogpt.memory import get_memory -cfg = Config() -memory = get_memory(cfg) +CFG = Config() +memory = get_memory(CFG) session = requests.Session() -session.headers.update({"User-Agent": cfg.user_agent}) +session.headers.update({"User-Agent": CFG.user_agent}) -# Function to check if the URL is valid -def is_valid_url(url): +def is_valid_url(url: str) -> bool: + """Check if the URL is valid + + Args: + url (str): The URL to check + + Returns: + bool: True if the URL is valid, False otherwise + """ try: result = urlparse(url) return all([result.scheme, result.netloc]) @@ -23,13 +32,27 @@ def is_valid_url(url): return False -# Function to sanitize the URL -def sanitize_url(url): +def sanitize_url(url: str) -> str: + """Sanitize the URL + + Args: + url (str): The URL to sanitize + + Returns: + str: The sanitized URL + """ return urljoin(url, urlparse(url).path) -# Define and check for local file address prefixes -def check_local_file_access(url): +def check_local_file_access(url: str) -> bool: + """Check if the URL is a local file + + Args: + url (str): The URL to check + + Returns: + bool: True if the URL is a local file, False otherwise + """ local_prefixes = [ "file:///", "file://localhost", @@ -39,7 +62,22 @@ def check_local_file_access(url): return any(url.startswith(prefix) for prefix in local_prefixes) -def get_response(url, timeout=10): +def get_response( + url: str, timeout: int = 10 +) -> Union[Tuple[None, str], Tuple[Response, None]]: + """Get the response from a URL + + Args: + url (str): The URL to get the response from + timeout (int): The timeout for the HTTP request + + Returns: + tuple[None, str] | tuple[Response, None]: The response and error message + + Raises: + ValueError: If the URL is invalid + requests.exceptions.RequestException: If the HTTP request fails + """ try: # Restrict access to local files if check_local_file_access(url): @@ -55,21 +93,28 @@ def get_response(url, timeout=10): # Check if the response contains an HTTP error if response.status_code >= 400: - return None, "Error: HTTP " + str(response.status_code) + " error" + return None, f"Error: HTTP {str(response.status_code)} error" return response, None except ValueError as ve: # Handle invalid URL format - return None, "Error: " + str(ve) + return None, f"Error: {str(ve)}" except requests.exceptions.RequestException as re: # Handle exceptions related to the HTTP request # (e.g., connection errors, timeouts, etc.) - return None, "Error: " + str(re) + return None, f"Error: {str(re)}" -def scrape_text(url): - """Scrape text from a webpage""" +def scrape_text(url: str) -> str: + """Scrape text from a webpage + + Args: + url (str): The URL to scrape text from + + Returns: + str: The scraped text + """ response, error_message = get_response(url) if error_message: return error_message @@ -89,24 +134,45 @@ def scrape_text(url): return text -def extract_hyperlinks(soup): - """Extract hyperlinks from a BeautifulSoup object""" +def extract_hyperlinks(soup: BeautifulSoup) -> List[Tuple[str, str]]: + """Extract hyperlinks from a BeautifulSoup object + + Args: + soup (BeautifulSoup): The BeautifulSoup object + + Returns: + List[Tuple[str, str]]: The extracted hyperlinks + """ hyperlinks = [] for link in soup.find_all("a", href=True): hyperlinks.append((link.text, link["href"])) return hyperlinks -def format_hyperlinks(hyperlinks): - """Format hyperlinks into a list of strings""" +def format_hyperlinks(hyperlinks: List[Tuple[str, str]]) -> List[str]: + """Format hyperlinks into a list of strings + + Args: + hyperlinks (List[Tuple[str, str]]): The hyperlinks to format + + Returns: + List[str]: The formatted hyperlinks + """ formatted_links = [] for link_text, link_url in hyperlinks: formatted_links.append(f"{link_text} ({link_url})") return formatted_links -def scrape_links(url): - """Scrape links from a webpage""" +def scrape_links(url: str) -> Union[str, List[str]]: + """Scrape links from a webpage + + Args: + url (str): The URL to scrape links from + + Returns: + Union[str, List[str]]: The scraped links + """ response, error_message = get_response(url) if error_message: return error_message @@ -122,25 +188,6 @@ def scrape_links(url): return format_hyperlinks(hyperlinks) -def split_text(text, max_length=cfg.browse_chunk_max_length): - """Split text into chunks of a maximum length""" - paragraphs = text.split("\n") - current_length = 0 - current_chunk = [] - - for paragraph in paragraphs: - if current_length + len(paragraph) + 1 <= max_length: - current_chunk.append(paragraph) - current_length += len(paragraph) + 1 - else: - yield "\n".join(current_chunk) - current_chunk = [paragraph] - current_length = len(paragraph) + 1 - - if current_chunk: - yield "\n".join(current_chunk) - - def create_message(chunk, question): """Create a message for the user to summarize a chunk of text""" return { @@ -149,50 +196,3 @@ def create_message(chunk, question): f' question: "{question}" -- if the question cannot be answered using the' " text, please summarize the text.", } - - -def summarize_text(url, text, question): - """Summarize text using the LLM model""" - if not text: - return "Error: No text to summarize" - - text_length = len(text) - print(f"Text length: {text_length} characters") - - summaries = [] - chunks = list(split_text(text)) - - for i, chunk in enumerate(chunks): - print(f"Adding chunk {i + 1} / {len(chunks)} to memory") - - memory_to_add = f"Source: {url}\n" f"Raw content part#{i + 1}: {chunk}" - - memory.add(memory_to_add) - - print(f"Summarizing chunk {i + 1} / {len(chunks)}") - messages = [create_message(chunk, question)] - - summary = create_chat_completion( - model=cfg.fast_llm_model, - messages=messages, - max_tokens=cfg.browse_summary_max_token, - ) - summaries.append(summary) - print(f"Added chunk {i + 1} summary to memory") - - memory_to_add = f"Source: {url}\n" f"Content summary part#{i + 1}: {summary}" - - memory.add(memory_to_add) - - print(f"Summarized {len(chunks)} chunks.") - - combined_summary = "\n".join(summaries) - messages = [create_message(combined_summary, question)] - - final_summary = create_chat_completion( - model=cfg.fast_llm_model, - messages=messages, - max_tokens=cfg.browse_summary_max_token, - ) - - return final_summary diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py new file mode 100644 index 0000000000..4d5703aa88 --- /dev/null +++ b/autogpt/commands/web_selenium.py @@ -0,0 +1,145 @@ +"""Selenium web scraping module.""" +from selenium import webdriver +import autogpt.processing.text as summary +from bs4 import BeautifulSoup +from selenium.webdriver.remote.webdriver import WebDriver +from selenium.webdriver.common.by import By +from selenium.webdriver.support.wait import WebDriverWait +from selenium.webdriver.support import expected_conditions as EC +from webdriver_manager.chrome import ChromeDriverManager +from selenium.webdriver.chrome.options import Options +import logging +from pathlib import Path +from autogpt.config import Config + +FILE_DIR = Path(__file__).parent.parent +CFG = Config() + + +def browse_website(url: str, question: str) -> tuple[str, WebDriver]: + """Browse a website and return the answer and links to the user + + Args: + url (str): The url of the website to browse + question (str): The question asked by the user + + Returns: + tuple[str, WebDriver]: The answer and links to the user and the webdriver + """ + driver, text = scrape_text_with_selenium(url) + add_header(driver) + summary_text = summary.summarize_text(url, text, question, driver) + links = scrape_links_with_selenium(driver) + + # Limit links to 5 + if len(links) > 5: + links = links[:5] + close_browser(driver) + return f"Answer gathered from website: {summary_text} \n \n Links: {links}", driver + + +def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: + """Scrape text from a website using selenium + + Args: + url (str): The url of the website to scrape + + Returns: + tuple[WebDriver, str]: The webdriver and the text scraped from the website + """ + logging.getLogger("selenium").setLevel(logging.CRITICAL) + + options = Options() + options.add_argument( + "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" + " (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" + ) + driver = webdriver.Chrome( + executable_path=ChromeDriverManager().install(), options=options + ) + driver.get(url) + + WebDriverWait(driver, 10).until( + EC.presence_of_element_located((By.TAG_NAME, "body")) + ) + + # Get the HTML content directly from the browser's DOM + page_source = driver.execute_script("return document.body.outerHTML;") + soup = BeautifulSoup(page_source, "html.parser") + + for script in soup(["script", "style"]): + script.extract() + + text = soup.get_text() + lines = (line.strip() for line in text.splitlines()) + chunks = (phrase.strip() for line in lines for phrase in line.split(" ")) + text = "\n".join(chunk for chunk in chunks if chunk) + return driver, text + + +def scrape_links_with_selenium(driver: WebDriver) -> list[str]: + """Scrape links from a website using selenium + + Args: + driver (WebDriver): The webdriver to use to scrape the links + + Returns: + list[str]: The links scraped from the website + """ + page_source = driver.page_source + soup = BeautifulSoup(page_source, "html.parser") + + for script in soup(["script", "style"]): + script.extract() + + hyperlinks = extract_hyperlinks(soup) + + return format_hyperlinks(hyperlinks) + + +def close_browser(driver: WebDriver) -> None: + """Close the browser + + Args: + driver (WebDriver): The webdriver to close + + Returns: + None + """ + driver.quit() + + +def extract_hyperlinks(soup: BeautifulSoup) -> list[tuple[str, str]]: + """Extract hyperlinks from a BeautifulSoup object + + Args: + soup (BeautifulSoup): The BeautifulSoup object to extract the hyperlinks from + + Returns: + list[tuple[str, str]]: The hyperlinks extracted from the BeautifulSoup object + """ + return [(link.text, link["href"]) for link in soup.find_all("a", href=True)] + + +def format_hyperlinks(hyperlinks: list[tuple[str, str]]) -> list[str]: + """Format hyperlinks to be displayed to the user + + Args: + hyperlinks (list[tuple[str, str]]): The hyperlinks to format + + Returns: + list[str]: The formatted hyperlinks + """ + return [f"{link_text} ({link_url})" for link_text, link_url in hyperlinks] + + +def add_header(driver: WebDriver) -> None: + """Add a header to the website + + Args: + driver (WebDriver): The webdriver to use to add the header + + Returns: + None + """ + driver.execute_script(open(f"{FILE_DIR}/js/overlay.js", "r").read()) diff --git a/autogpt/commands/write_tests.py b/autogpt/commands/write_tests.py new file mode 100644 index 0000000000..f1d6c9b2ce --- /dev/null +++ b/autogpt/commands/write_tests.py @@ -0,0 +1,29 @@ +"""A module that contains a function to generate test cases for the submitted code.""" +import json +from typing import List +from autogpt.llm_utils import call_ai_function + + +def write_tests(code: str, focus: List[str]) -> str: + """ + A function that takes in code and focus topics and returns a response from create + chat completion api call. + + Parameters: + focus (List): A list of suggestions around what needs to be improved. + code (str): Code for test cases to be generated against. + Returns: + A result string from create chat completion. Test cases for the submitted code + in response. + """ + + function_string = ( + "def create_test_cases(code: str, focus: Optional[str] = None) -> str:" + ) + args = [code, json.dumps(focus)] + description_string = ( + "Generates test cases for the existing code, focusing on" + " specific areas if required." + ) + + return call_ai_function(function_string, args, description_string) diff --git a/autogpt/config/__init__.py b/autogpt/config/__init__.py new file mode 100644 index 0000000000..ceb5566ce7 --- /dev/null +++ b/autogpt/config/__init__.py @@ -0,0 +1,14 @@ +""" +This module contains the configuration classes for AutoGPT. +""" +from autogpt.config.ai_config import AIConfig +from autogpt.config.config import check_openai_api_key, Config +from autogpt.config.singleton import AbstractSingleton, Singleton + +__all__ = [ + "check_openai_api_key", + "AbstractSingleton", + "AIConfig", + "Config", + "Singleton", +] diff --git a/autogpt/ai_config.py b/autogpt/config/ai_config.py similarity index 87% rename from autogpt/ai_config.py rename to autogpt/config/ai_config.py index 0957b88662..c72b088bdf 100644 --- a/autogpt/ai_config.py +++ b/autogpt/config/ai_config.py @@ -1,9 +1,11 @@ +# sourcery skip: do-not-use-staticmethod +""" +A module that contains the AIConfig class object that contains the configuration +""" import os -from typing import Type +from typing import List, Optional, Type import yaml -from autogpt.prompt import get_prompt - class AIConfig: """ @@ -16,7 +18,7 @@ class AIConfig: """ def __init__( - self, ai_name: str = "", ai_role: str = "", ai_goals: list = [] + self, ai_name: str = "", ai_role: str = "", ai_goals: Optional[List] = None ) -> None: """ Initialize a class instance @@ -28,7 +30,8 @@ class AIConfig: Returns: None """ - + if ai_goals is None: + ai_goals = [] self.ai_name = ai_name self.ai_role = ai_role self.ai_goals = ai_goals @@ -36,15 +39,14 @@ class AIConfig: # Soon this will go in a folder where it remembers more stuff about the run(s) SAVE_FILE = os.path.join(os.path.dirname(__file__), "..", "ai_settings.yaml") - @classmethod - def load(cls: "Type[AIConfig]", config_file: str = SAVE_FILE) -> "Type[AIConfig]": + @staticmethod + def load(config_file: str = SAVE_FILE) -> "AIConfig": """ Returns class object with parameters (ai_name, ai_role, ai_goals) loaded from yaml file if yaml file exists, else returns class with no parameters. Parameters: - cls (class object): An AIConfig Class object. config_file (int): The path to the config yaml file. DEFAULT: "../ai_settings.yaml" @@ -62,7 +64,7 @@ class AIConfig: ai_role = config_params.get("ai_role", "") ai_goals = config_params.get("ai_goals", []) # type: Type[AIConfig] - return cls(ai_name, ai_role, ai_goals) + return AIConfig(ai_name, ai_role, ai_goals) def save(self, config_file: str = SAVE_FILE) -> None: """ @@ -103,6 +105,8 @@ class AIConfig: "" ) + from autogpt.prompt import get_prompt + # Construct full prompt full_prompt = ( f"You are {self.ai_name}, {self.ai_role}\n{prompt_start}\n\nGOALS:\n\n" diff --git a/autogpt/config.py b/autogpt/config/config.py similarity index 76% rename from autogpt/config.py rename to autogpt/config/config.py index 26132a5abb..46764b9c0b 100644 --- a/autogpt/config.py +++ b/autogpt/config/config.py @@ -1,30 +1,15 @@ -import abc +"""Configuration class to store the state of bools for different scripts access.""" import os +from colorama import Fore + +from autogpt.config.singleton import Singleton import openai import yaml + from dotenv import load_dotenv -# Load environment variables from .env file -load_dotenv() - - -class Singleton(abc.ABCMeta, type): - """ - Singleton metaclass for ensuring only one instance of a class. - """ - - _instances = {} - - def __call__(cls, *args, **kwargs): - """Call method for the singleton metaclass.""" - if cls not in cls._instances: - cls._instances[cls] = super(Singleton, cls).__call__(*args, **kwargs) - return cls._instances[cls] - - -class AbstractSingleton(abc.ABC, metaclass=Singleton): - pass +load_dotenv(verbose=True) class Config(metaclass=Singleton): @@ -32,7 +17,7 @@ class Config(metaclass=Singleton): Configuration class to store the state of bools for different scripts access. """ - def __init__(self): + def __init__(self) -> None: """Initialize the Config class""" self.debug_mode = False self.continuous_mode = False @@ -81,10 +66,12 @@ class Config(metaclass=Singleton): self.huggingface_api_token = os.getenv("HUGGINGFACE_API_TOKEN") # User agent headers to use when browsing web - # Some websites might just completely deny request with an error code if no user agent was found. + # Some websites might just completely deny request with an error code if + # no user agent was found. self.user_agent = os.getenv( "USER_AGENT", - "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36", + "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36" + " (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36", ) self.redis_host = os.getenv("REDIS_HOST", "localhost") self.redis_port = os.getenv("REDIS_PORT", "6379") @@ -108,15 +95,17 @@ class Config(metaclass=Singleton): The matching deployment id if found, otherwise an empty string. """ if model == self.fast_llm_model: - return self.azure_model_to_deployment_id_map["fast_llm_model_deployment_id"] + return self.azure_model_to_deployment_id_map[ + "fast_llm_model_deployment_id" + ] # type: ignore elif model == self.smart_llm_model: return self.azure_model_to_deployment_id_map[ "smart_llm_model_deployment_id" - ] + ] # type: ignore elif model == "text-embedding-ada-002": return self.azure_model_to_deployment_id_map[ "embedding_model_deployment_id" - ] + ] # type: ignore else: return "" @@ -124,7 +113,8 @@ class Config(metaclass=Singleton): def load_azure_config(self, config_file: str = AZURE_CONFIG_FILE) -> None: """ - Loads the configuration parameters for Azure hosting from the specified file path as a yaml file. + Loads the configuration parameters for Azure hosting from the specified file + path as a yaml file. Parameters: config_file(str): The path to the config yaml file. DEFAULT: "../azure.yaml" @@ -148,74 +138,86 @@ class Config(metaclass=Singleton): ) self.azure_model_to_deployment_id_map = config_params.get("azure_model_map", []) - def set_continuous_mode(self, value: bool): + def set_continuous_mode(self, value: bool) -> None: """Set the continuous mode value.""" self.continuous_mode = value - def set_continuous_limit(self, value: int): + def set_continuous_limit(self, value: int) -> None: """Set the continuous limit value.""" self.continuous_limit = value - def set_speak_mode(self, value: bool): + def set_speak_mode(self, value: bool) -> None: """Set the speak mode value.""" self.speak_mode = value - def set_fast_llm_model(self, value: str): + def set_fast_llm_model(self, value: str) -> None: """Set the fast LLM model value.""" self.fast_llm_model = value - def set_smart_llm_model(self, value: str): + def set_smart_llm_model(self, value: str) -> None: """Set the smart LLM model value.""" self.smart_llm_model = value - def set_fast_token_limit(self, value: int): + def set_fast_token_limit(self, value: int) -> None: """Set the fast token limit value.""" self.fast_token_limit = value - def set_smart_token_limit(self, value: int): + def set_smart_token_limit(self, value: int) -> None: """Set the smart token limit value.""" self.smart_token_limit = value - def set_browse_chunk_max_length(self, value: int): + def set_browse_chunk_max_length(self, value: int) -> None: """Set the browse_website command chunk max length value.""" self.browse_chunk_max_length = value - def set_browse_summary_max_token(self, value: int): + def set_browse_summary_max_token(self, value: int) -> None: """Set the browse_website command summary max token value.""" self.browse_summary_max_token = value - def set_openai_api_key(self, value: str): + def set_openai_api_key(self, value: str) -> None: """Set the OpenAI API key value.""" self.openai_api_key = value - def set_elevenlabs_api_key(self, value: str): + def set_elevenlabs_api_key(self, value: str) -> None: """Set the ElevenLabs API key value.""" self.elevenlabs_api_key = value - def set_elevenlabs_voice_1_id(self, value: str): + def set_elevenlabs_voice_1_id(self, value: str) -> None: """Set the ElevenLabs Voice 1 ID value.""" self.elevenlabs_voice_1_id = value - def set_elevenlabs_voice_2_id(self, value: str): + def set_elevenlabs_voice_2_id(self, value: str) -> None: """Set the ElevenLabs Voice 2 ID value.""" self.elevenlabs_voice_2_id = value - def set_google_api_key(self, value: str): + def set_google_api_key(self, value: str) -> None: """Set the Google API key value.""" self.google_api_key = value - def set_custom_search_engine_id(self, value: str): + def set_custom_search_engine_id(self, value: str) -> None: """Set the custom search engine id value.""" self.custom_search_engine_id = value - def set_pinecone_api_key(self, value: str): + def set_pinecone_api_key(self, value: str) -> None: """Set the Pinecone API key value.""" self.pinecone_api_key = value - def set_pinecone_region(self, value: str): + def set_pinecone_region(self, value: str) -> None: """Set the Pinecone region value.""" self.pinecone_region = value - def set_debug_mode(self, value: bool): + def set_debug_mode(self, value: bool) -> None: """Set the debug mode value.""" self.debug_mode = value + + +def check_openai_api_key() -> None: + """Check if the OpenAI API key is set in config.py or as an environment variable.""" + cfg = Config() + if not cfg.openai_api_key: + print( + Fore.RED + + "Please set your OpenAI API key in .env or as an environment variable." + ) + print("You can get your key from https://beta.openai.com/account/api-keys") + exit(1) diff --git a/autogpt/config/singleton.py b/autogpt/config/singleton.py new file mode 100644 index 0000000000..55b2aeea12 --- /dev/null +++ b/autogpt/config/singleton.py @@ -0,0 +1,24 @@ +"""The singleton metaclass for ensuring only one instance of a class.""" +import abc + + +class Singleton(abc.ABCMeta, type): + """ + Singleton metaclass for ensuring only one instance of a class. + """ + + _instances = {} + + def __call__(cls, *args, **kwargs): + """Call method for the singleton metaclass.""" + if cls not in cls._instances: + cls._instances[cls] = super(Singleton, cls).__call__(*args, **kwargs) + return cls._instances[cls] + + +class AbstractSingleton(abc.ABC, metaclass=Singleton): + """ + Abstract singleton class for ensuring only one instance of a class. + """ + + pass diff --git a/autogpt/data_ingestion.py b/autogpt/data_ingestion.py index 9df2b9e67a..01bafc2ad0 100644 --- a/autogpt/data_ingestion.py +++ b/autogpt/data_ingestion.py @@ -2,7 +2,7 @@ import argparse import logging from autogpt.config import Config -from autogpt.file_operations import ingest_file, search_files +from autogpt.commands.file_operations import ingest_file, search_files from autogpt.memory import get_memory cfg = Config() @@ -87,7 +87,8 @@ def main() -> None: print(f"Error while ingesting directory '{args.dir}': {str(e)}") else: print( - "Please provide either a file path (--file) or a directory name (--dir) inside the auto_gpt_workspace directory as input." + "Please provide either a file path (--file) or a directory name (--dir)" + " inside the auto_gpt_workspace directory as input." ) diff --git a/autogpt/execute_code.py b/autogpt/execute_code.py deleted file mode 100644 index c5f85a04ee..0000000000 --- a/autogpt/execute_code.py +++ /dev/null @@ -1,105 +0,0 @@ -import os -import subprocess - -import docker -from docker.errors import ImageNotFound - -WORKSPACE_FOLDER = "auto_gpt_workspace" - - -def execute_python_file(file): - """Execute a Python file in a Docker container and return the output""" - - print(f"Executing file '{file}' in workspace '{WORKSPACE_FOLDER}'") - - if not file.endswith(".py"): - return "Error: Invalid file type. Only .py files are allowed." - - file_path = os.path.join(WORKSPACE_FOLDER, file) - - if not os.path.isfile(file_path): - return f"Error: File '{file}' does not exist." - - if we_are_running_in_a_docker_container(): - result = subprocess.run( - f"python {file_path}", capture_output=True, encoding="utf8", shell=True - ) - if result.returncode == 0: - return result.stdout - else: - return f"Error: {result.stderr}" - else: - try: - client = docker.from_env() - - image_name = "python:3.10" - try: - client.images.get(image_name) - print(f"Image '{image_name}' found locally") - except ImageNotFound: - print( - f"Image '{image_name}' not found locally, pulling from Docker Hub" - ) - # Use the low-level API to stream the pull response - low_level_client = docker.APIClient() - for line in low_level_client.pull(image_name, stream=True, decode=True): - # Print the status and progress, if available - status = line.get("status") - progress = line.get("progress") - if status and progress: - print(f"{status}: {progress}") - elif status: - print(status) - - # You can replace 'python:3.8' with the desired Python image/version - # You can find available Python images on Docker Hub: - # https://hub.docker.com/_/python - container = client.containers.run( - image_name, - f"python {file}", - volumes={ - os.path.abspath(WORKSPACE_FOLDER): { - "bind": "/workspace", - "mode": "ro", - } - }, - working_dir="/workspace", - stderr=True, - stdout=True, - detach=True, - ) - - container.wait() - logs = container.logs().decode("utf-8") - container.remove() - - # print(f"Execution complete. Output: {output}") - # print(f"Logs: {logs}") - - return logs - - except Exception as e: - return f"Error: {str(e)}" - - -def execute_shell(command_line): - current_dir = os.getcwd() - - if WORKSPACE_FOLDER not in current_dir: # Change dir into workspace if necessary - work_dir = os.path.join(os.getcwd(), WORKSPACE_FOLDER) - os.chdir(work_dir) - - print(f"Executing command '{command_line}' in working directory '{os.getcwd()}'") - - result = subprocess.run(command_line, capture_output=True, shell=True) - output = f"STDOUT:\n{result.stdout}\nSTDERR:\n{result.stderr}" - - # Change back to whatever the prior working dir was - - os.chdir(current_dir) - - return output - - -def we_are_running_in_a_docker_container(): - os.path.exists("/.dockerenv") diff --git a/autogpt/image_gen.py b/autogpt/image_gen.py deleted file mode 100644 index 9d5694e4d6..0000000000 --- a/autogpt/image_gen.py +++ /dev/null @@ -1,67 +0,0 @@ -import io -import os.path -import uuid -from base64 import b64decode - -import openai -import requests -from PIL import Image - -from autogpt.config import Config - -cfg = Config() - -working_directory = "auto_gpt_workspace" - - -def generate_image(prompt): - filename = str(uuid.uuid4()) + ".jpg" - - # DALL-E - if cfg.image_provider == "dalle": - openai.api_key = cfg.openai_api_key - - response = openai.Image.create( - prompt=prompt, - n=1, - size="256x256", - response_format="b64_json", - ) - - print("Image Generated for prompt:" + prompt) - - image_data = b64decode(response["data"][0]["b64_json"]) - - with open(working_directory + "/" + filename, mode="wb") as png: - png.write(image_data) - - return "Saved to disk:" + filename - - # STABLE DIFFUSION - elif cfg.image_provider == "sd": - API_URL = ( - "https://api-inference.huggingface.co/models/CompVis/stable-diffusion-v1-4" - ) - if cfg.huggingface_api_token is None: - raise ValueError( - "You need to set your Hugging Face API token in the config file." - ) - headers = {"Authorization": "Bearer " + cfg.huggingface_api_token} - - response = requests.post( - API_URL, - headers=headers, - json={ - "inputs": prompt, - }, - ) - - image = Image.open(io.BytesIO(response.content)) - print("Image Generated for prompt:" + prompt) - - image.save(os.path.join(working_directory, filename)) - - return "Saved to disk:" + filename - - else: - return "No Image Provider Set" diff --git a/autogpt/json_fixes/__init__.py b/autogpt/json_fixes/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/autogpt/json_fixes/auto_fix.py b/autogpt/json_fixes/auto_fix.py new file mode 100644 index 0000000000..60c089a2fb --- /dev/null +++ b/autogpt/json_fixes/auto_fix.py @@ -0,0 +1,40 @@ +"""This module contains the function to fix JSON strings using GPT-3.""" +import json +from autogpt.llm_utils import call_ai_function +from autogpt.logs import logger + + +def fix_json(json_str: str, schema: str) -> str: + """Fix the given JSON string to make it parseable and fully compliant with the provided schema.""" + # Try to fix the JSON using GPT: + function_string = "def fix_json(json_str: str, schema:str=None) -> str:" + args = [f"'''{json_str}'''", f"'''{schema}'''"] + description_string = ( + "Fixes the provided JSON string to make it parseable" + " and fully compliant with the provided schema.\n If an object or" + " field specified in the schema isn't contained within the correct" + " JSON, it is omitted.\n This function is brilliant at guessing" + " when the format is incorrect." + ) + + # If it doesn't already start with a "`", add one: + if not json_str.startswith("`"): + json_str = "```json\n" + json_str + "\n```" + result_string = call_ai_function( + function_string, args, description_string, model=cfg.fast_llm_model + ) + logger.debug("------------ JSON FIX ATTEMPT ---------------") + logger.debug(f"Original JSON: {json_str}") + logger.debug("-----------") + logger.debug(f"Fixed JSON: {result_string}") + logger.debug("----------- END OF FIX ATTEMPT ----------------") + + try: + json.loads(result_string) # just check the validity + return result_string + except: # noqa: E722 + # Get the call stack: + # import traceback + # call_stack = traceback.format_exc() + # print(f"Failed to fix JSON: '{json_str}' "+call_stack) + return "failed" diff --git a/autogpt/json_fixes/bracket_termination.py b/autogpt/json_fixes/bracket_termination.py new file mode 100644 index 0000000000..13c2ccfd96 --- /dev/null +++ b/autogpt/json_fixes/bracket_termination.py @@ -0,0 +1,73 @@ +"""Fix JSON brackets.""" +import contextlib +import json +from typing import Optional +import regex +from colorama import Fore + +from autogpt.logs import logger +from autogpt.config import Config +from autogpt.speech import say_text + +CFG = Config() + + +def attempt_to_fix_json_by_finding_outermost_brackets(json_string: str): + if CFG.speak_mode and CFG.debug_mode: + say_text( + "I have received an invalid JSON response from the OpenAI API. " + "Trying to fix it now." + ) + logger.typewriter_log("Attempting to fix JSON by finding outermost brackets\n") + + try: + json_pattern = regex.compile(r"\{(?:[^{}]|(?R))*\}") + json_match = json_pattern.search(json_string) + + if json_match: + # Extract the valid JSON object from the string + json_string = json_match.group(0) + logger.typewriter_log( + title="Apparently json was fixed.", title_color=Fore.GREEN + ) + if CFG.speak_mode and CFG.debug_mode: + say_text("Apparently json was fixed.") + else: + raise ValueError("No valid JSON object found") + + except (json.JSONDecodeError, ValueError): + if CFG.debug_mode: + logger.error("Error: Invalid JSON: %s\n", json_string) + if CFG.speak_mode: + say_text("Didn't work. I will have to ignore this response then.") + logger.error("Error: Invalid JSON, setting it to empty JSON now.\n") + json_string = {} + + return json_string + + +def balance_braces(json_string: str) -> Optional[str]: + """ + Balance the braces in a JSON string. + + Args: + json_string (str): The JSON string. + + Returns: + str: The JSON string with braces balanced. + """ + + open_braces_count = json_string.count("{") + close_braces_count = json_string.count("}") + + while open_braces_count > close_braces_count: + json_string += "}" + close_braces_count += 1 + + while close_braces_count > open_braces_count: + json_string = json_string.rstrip("}") + close_braces_count -= 1 + + with contextlib.suppress(json.JSONDecodeError): + json.loads(json_string) + return json_string diff --git a/autogpt/json_fixes/escaping.py b/autogpt/json_fixes/escaping.py new file mode 100644 index 0000000000..68eb171451 --- /dev/null +++ b/autogpt/json_fixes/escaping.py @@ -0,0 +1,33 @@ +""" Fix invalid escape sequences in JSON strings. """ +import json + +from autogpt.config import Config +from autogpt.json_fixes.utilities import extract_char_position + +CFG = Config() + + +def fix_invalid_escape(json_to_load: str, error_message: str) -> str: + """Fix invalid escape sequences in JSON strings. + + Args: + json_to_load (str): The JSON string. + error_message (str): The error message from the JSONDecodeError + exception. + + Returns: + str: The JSON string with invalid escape sequences fixed. + """ + while error_message.startswith("Invalid \\escape"): + bad_escape_location = extract_char_position(error_message) + json_to_load = ( + json_to_load[:bad_escape_location] + json_to_load[bad_escape_location + 1 :] + ) + try: + json.loads(json_to_load) + return json_to_load + except json.JSONDecodeError as e: + if CFG.debug_mode: + print("json loads error - fix invalid escape", e) + error_message = str(e) + return json_to_load diff --git a/autogpt/json_fixes/missing_quotes.py b/autogpt/json_fixes/missing_quotes.py new file mode 100644 index 0000000000..552a15173d --- /dev/null +++ b/autogpt/json_fixes/missing_quotes.py @@ -0,0 +1,27 @@ +"""Fix quotes in a JSON string.""" +import json +import re + + +def add_quotes_to_property_names(json_string: str) -> str: + """ + Add quotes to property names in a JSON string. + + Args: + json_string (str): The JSON string. + + Returns: + str: The JSON string with quotes added to property names. + """ + + def replace_func(match: re.Match) -> str: + return f'"{match[1]}":' + + property_name_pattern = re.compile(r"(\w+):") + corrected_json_string = property_name_pattern.sub(replace_func, json_string) + + try: + json.loads(corrected_json_string) + return corrected_json_string + except json.JSONDecodeError as e: + raise e diff --git a/autogpt/json_fixes/parsing.py b/autogpt/json_fixes/parsing.py new file mode 100644 index 0000000000..26d067939e --- /dev/null +++ b/autogpt/json_fixes/parsing.py @@ -0,0 +1,143 @@ +"""Fix and parse JSON strings.""" + +import contextlib +import json +from typing import Any, Dict, Union + +from autogpt.config import Config +from autogpt.json_fixes.auto_fix import fix_json +from autogpt.json_fixes.bracket_termination import balance_braces +from autogpt.json_fixes.escaping import fix_invalid_escape +from autogpt.json_fixes.missing_quotes import add_quotes_to_property_names +from autogpt.logs import logger + +CFG = Config() + + +JSON_SCHEMA = """ +{ + "command": { + "name": "command name", + "args": { + "arg name": "value" + } + }, + "thoughts": + { + "text": "thought", + "reasoning": "reasoning", + "plan": "- short bulleted\n- list that conveys\n- long-term plan", + "criticism": "constructive self-criticism", + "speak": "thoughts summary to say to user" + } +} +""" + + +def correct_json(json_to_load: str) -> str: + """ + Correct common JSON errors. + + Args: + json_to_load (str): The JSON string. + """ + + try: + if CFG.debug_mode: + print("json", json_to_load) + json.loads(json_to_load) + return json_to_load + except json.JSONDecodeError as e: + if CFG.debug_mode: + print("json loads error", e) + error_message = str(e) + if error_message.startswith("Invalid \\escape"): + json_to_load = fix_invalid_escape(json_to_load, error_message) + if error_message.startswith( + "Expecting property name enclosed in double quotes" + ): + json_to_load = add_quotes_to_property_names(json_to_load) + try: + json.loads(json_to_load) + return json_to_load + except json.JSONDecodeError as e: + if CFG.debug_mode: + print("json loads error - add quotes", e) + error_message = str(e) + if balanced_str := balance_braces(json_to_load): + return balanced_str + return json_to_load + + +def fix_and_parse_json( + json_to_load: str, try_to_fix_with_gpt: bool = True +) -> Union[str, Dict[Any, Any]]: + """Fix and parse JSON string + + Args: + json_to_load (str): The JSON string. + try_to_fix_with_gpt (bool, optional): Try to fix the JSON with GPT. + Defaults to True. + + Returns: + Union[str, Dict[Any, Any]]: The parsed JSON. + """ + + with contextlib.suppress(json.JSONDecodeError): + json_to_load = json_to_load.replace("\t", "") + return json.loads(json_to_load) + + with contextlib.suppress(json.JSONDecodeError): + json_to_load = correct_json(json_to_load) + return json.loads(json_to_load) + # Let's do something manually: + # sometimes GPT responds with something BEFORE the braces: + # "I'm sorry, I don't understand. Please try again." + # {"text": "I'm sorry, I don't understand. Please try again.", + # "confidence": 0.0} + # So let's try to find the first brace and then parse the rest + # of the string + try: + brace_index = json_to_load.index("{") + maybe_fixed_json = json_to_load[brace_index:] + last_brace_index = maybe_fixed_json.rindex("}") + maybe_fixed_json = maybe_fixed_json[: last_brace_index + 1] + return json.loads(maybe_fixed_json) + except (json.JSONDecodeError, ValueError) as e: + return try_ai_fix(try_to_fix_with_gpt, e, json_to_load) + + +def try_ai_fix( + try_to_fix_with_gpt: bool, exception: Exception, json_to_load: str +) -> Union[str, Dict[Any, Any]]: + """Try to fix the JSON with the AI + + Args: + try_to_fix_with_gpt (bool): Whether to try to fix the JSON with the AI. + exception (Exception): The exception that was raised. + json_to_load (str): The JSON string to load. + + Raises: + exception: If try_to_fix_with_gpt is False. + + Returns: + Union[str, Dict[Any, Any]]: The JSON string or dictionary. + """ + if not try_to_fix_with_gpt: + raise exception + + logger.warn( + "Warning: Failed to parse AI output, attempting to fix." + "\n If you see this warning frequently, it's likely that" + " your prompt is confusing the AI. Try changing it up" + " slightly." + ) + # Now try to fix this up using the ai_functions + ai_fixed_json = fix_json(json_to_load, JSON_SCHEMA) + + if ai_fixed_json != "failed": + return json.loads(ai_fixed_json) + # This allows the AI to react to the error message, + # which usually results in it correcting its ways. + logger.error("Failed to fix AI output, telling the AI.") + return json_to_load diff --git a/autogpt/json_fixes/utilities.py b/autogpt/json_fixes/utilities.py new file mode 100644 index 0000000000..0852b18a7a --- /dev/null +++ b/autogpt/json_fixes/utilities.py @@ -0,0 +1,20 @@ +"""Utilities for the json_fixes package.""" +import re + + +def extract_char_position(error_message: str) -> int: + """Extract the character position from the JSONDecodeError message. + + Args: + error_message (str): The error message from the JSONDecodeError + exception. + + Returns: + int: The character position. + """ + + char_pattern = re.compile(r"\(char (\d+)\)") + if match := char_pattern.search(error_message): + return int(match[1]) + else: + raise ValueError("Character position not found in the error message.") diff --git a/autogpt/json_parser.py b/autogpt/json_parser.py deleted file mode 100644 index b32146da71..0000000000 --- a/autogpt/json_parser.py +++ /dev/null @@ -1,113 +0,0 @@ -import json -from typing import Any, Dict, Union - -from autogpt.call_ai_function import call_ai_function -from autogpt.config import Config -from autogpt.json_utils import correct_json -from autogpt.logger import logger - -cfg = Config() - -JSON_SCHEMA = """ -{ - "command": { - "name": "command name", - "args": { - "arg name": "value" - } - }, - "thoughts": - { - "text": "thought", - "reasoning": "reasoning", - "plan": "- short bulleted\n- list that conveys\n- long-term plan", - "criticism": "constructive self-criticism", - "speak": "thoughts summary to say to user" - } -} -""" - - -def fix_and_parse_json( - json_str: str, try_to_fix_with_gpt: bool = True -) -> Union[str, Dict[Any, Any]]: - """Fix and parse JSON string""" - try: - json_str = json_str.replace("\t", "") - return json.loads(json_str) - except json.JSONDecodeError as _: # noqa: F841 - try: - json_str = correct_json(json_str) - return json.loads(json_str) - except json.JSONDecodeError as _: # noqa: F841 - pass - # Let's do something manually: - # sometimes GPT responds with something BEFORE the braces: - # "I'm sorry, I don't understand. Please try again." - # {"text": "I'm sorry, I don't understand. Please try again.", - # "confidence": 0.0} - # So let's try to find the first brace and then parse the rest - # of the string - try: - brace_index = json_str.index("{") - json_str = json_str[brace_index:] - last_brace_index = json_str.rindex("}") - json_str = json_str[: last_brace_index + 1] - return json.loads(json_str) - # Can throw a ValueError if there is no "{" or "}" in the json_str - except (json.JSONDecodeError, ValueError) as e: # noqa: F841 - if try_to_fix_with_gpt: - logger.warn( - "Warning: Failed to parse AI output, attempting to fix." - "\n If you see this warning frequently, it's likely that" - " your prompt is confusing the AI. Try changing it up" - " slightly." - ) - # Now try to fix this up using the ai_functions - ai_fixed_json = fix_json(json_str, JSON_SCHEMA) - - if ai_fixed_json != "failed": - return json.loads(ai_fixed_json) - else: - # This allows the AI to react to the error message, - # which usually results in it correcting its ways. - logger.error("Failed to fix AI output, telling the AI.") - return json_str - else: - raise e - - -def fix_json(json_str: str, schema: str) -> str: - """Fix the given JSON string to make it parseable and fully compliant with the provided schema.""" - # Try to fix the JSON using GPT: - function_string = "def fix_json(json_str: str, schema:str=None) -> str:" - args = [f"'''{json_str}'''", f"'''{schema}'''"] - description_string = ( - "Fixes the provided JSON string to make it parseable" - " and fully compliant with the provided schema.\n If an object or" - " field specified in the schema isn't contained within the correct" - " JSON, it is omitted.\n This function is brilliant at guessing" - " when the format is incorrect." - ) - - # If it doesn't already start with a "`", add one: - if not json_str.startswith("`"): - json_str = "```json\n" + json_str + "\n```" - result_string = call_ai_function( - function_string, args, description_string, model=cfg.fast_llm_model - ) - logger.debug("------------ JSON FIX ATTEMPT ---------------") - logger.debug(f"Original JSON: {json_str}") - logger.debug("-----------") - logger.debug(f"Fixed JSON: {result_string}") - logger.debug("----------- END OF FIX ATTEMPT ----------------") - - try: - json.loads(result_string) # just check the validity - return result_string - except: # noqa: E722 - # Get the call stack: - # import traceback - # call_stack = traceback.format_exc() - # print(f"Failed to fix JSON: '{json_str}' "+call_stack) - return "failed" diff --git a/autogpt/json_utils.py b/autogpt/json_utils.py deleted file mode 100644 index 848f9fff8c..0000000000 --- a/autogpt/json_utils.py +++ /dev/null @@ -1,128 +0,0 @@ -import json -import re -from typing import Optional - -from autogpt.config import Config - -cfg = Config() - - -def extract_char_position(error_message: str) -> int: - """Extract the character position from the JSONDecodeError message. - - Args: - error_message (str): The error message from the JSONDecodeError - exception. - - Returns: - int: The character position. - """ - import re - - char_pattern = re.compile(r"\(char (\d+)\)") - if match := char_pattern.search(error_message): - return int(match[1]) - else: - raise ValueError("Character position not found in the error message.") - - -def add_quotes_to_property_names(json_string: str) -> str: - """ - Add quotes to property names in a JSON string. - - Args: - json_string (str): The JSON string. - - Returns: - str: The JSON string with quotes added to property names. - """ - - def replace_func(match): - return f'"{match.group(1)}":' - - property_name_pattern = re.compile(r"(\w+):") - corrected_json_string = property_name_pattern.sub(replace_func, json_string) - - try: - json.loads(corrected_json_string) - return corrected_json_string - except json.JSONDecodeError as e: - raise e - - -def balance_braces(json_string: str) -> Optional[str]: - """ - Balance the braces in a JSON string. - - Args: - json_string (str): The JSON string. - - Returns: - str: The JSON string with braces balanced. - """ - - open_braces_count = json_string.count("{") - close_braces_count = json_string.count("}") - - while open_braces_count > close_braces_count: - json_string += "}" - close_braces_count += 1 - - while close_braces_count > open_braces_count: - json_string = json_string.rstrip("}") - close_braces_count -= 1 - - try: - json.loads(json_string) - return json_string - except json.JSONDecodeError: - pass - - -def fix_invalid_escape(json_str: str, error_message: str) -> str: - while error_message.startswith("Invalid \\escape"): - bad_escape_location = extract_char_position(error_message) - json_str = json_str[:bad_escape_location] + json_str[bad_escape_location + 1 :] - try: - json.loads(json_str) - return json_str - except json.JSONDecodeError as e: - if cfg.debug_mode: - print("json loads error - fix invalid escape", e) - error_message = str(e) - return json_str - - -def correct_json(json_str: str) -> str: - """ - Correct common JSON errors. - - Args: - json_str (str): The JSON string. - """ - - try: - if cfg.debug_mode: - print("json", json_str) - json.loads(json_str) - return json_str - except json.JSONDecodeError as e: - if cfg.debug_mode: - print("json loads error", e) - error_message = str(e) - if error_message.startswith("Invalid \\escape"): - json_str = fix_invalid_escape(json_str, error_message) - if error_message.startswith( - "Expecting property name enclosed in double quotes" - ): - json_str = add_quotes_to_property_names(json_str) - try: - json.loads(json_str) - return json_str - except json.JSONDecodeError as e: - if cfg.debug_mode: - print("json loads error - add quotes", e) - error_message = str(e) - if balanced_str := balance_braces(json_str): - return balanced_str - return json_str diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index 7503dc448b..f2418b658f 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -1,4 +1,6 @@ +from ast import List import time +from typing import Dict, Optional import openai from openai.error import APIError, RateLimitError @@ -6,30 +8,79 @@ from colorama import Fore from autogpt.config import Config -cfg = Config() +CFG = Config() -openai.api_key = cfg.openai_api_key +openai.api_key = CFG.openai_api_key + + +def call_ai_function( + function: str, args: List, description: str, model: Optional[str] = None +) -> str: + """Call an AI function + + This is a magic function that can do anything with no-code. See + https://github.com/Torantulino/AI-Functions for more info. + + Args: + function (str): The function to call + args (list): The arguments to pass to the function + description (str): The description of the function + model (str, optional): The model to use. Defaults to None. + + Returns: + str: The response from the function + """ + if model is None: + model = CFG.smart_llm_model + # For each arg, if any are None, convert to "None": + args = [str(arg) if arg is not None else "None" for arg in args] + # parse args to comma separated string + args = ", ".join(args) + messages = [ + { + "role": "system", + "content": f"You are now the following python function: ```# {description}" + f"\n{function}```\n\nOnly respond with your `return` value.", + }, + {"role": "user", "content": args}, + ] + + return create_chat_completion(model=model, messages=messages, temperature=0) # Overly simple abstraction until we create something better # simple retry mechanism when getting a rate error or a bad gateway def create_chat_completion( - messages, model=None, temperature=cfg.temperature, max_tokens=None + messages: List, # type: ignore + model: Optional[str] = None, + temperature: float = CFG.temperature, + max_tokens: Optional[int] = None, ) -> str: - """Create a chat completion using the OpenAI API""" + """Create a chat completion using the OpenAI API + + Args: + messages (list[dict[str, str]]): The messages to send to the chat completion + model (str, optional): The model to use. Defaults to None. + temperature (float, optional): The temperature to use. Defaults to 0.9. + max_tokens (int, optional): The max tokens to use. Defaults to None. + + Returns: + str: The response from the chat completion + """ response = None - num_retries = 5 - if cfg.debug_mode: + num_retries = 10 + if CFG.debug_mode: print( Fore.GREEN + f"Creating chat completion with model {model}, temperature {temperature}," f" max_tokens {max_tokens}" + Fore.RESET ) for attempt in range(num_retries): + backoff = 2 ** (attempt + 2) try: - if cfg.use_azure: + if CFG.use_azure: response = openai.ChatCompletion.create( - deployment_id=cfg.get_azure_deployment_id_for_model(model), + deployment_id=CFG.get_azure_deployment_id_for_model(model), model=model, messages=messages, temperature=temperature, @@ -44,26 +95,21 @@ def create_chat_completion( ) break except RateLimitError: - if cfg.debug_mode: - print( - Fore.RED + "Error: ", - "API Rate Limit Reached. Waiting 20 seconds..." + Fore.RESET, - ) - time.sleep(20) + pass except APIError as e: if e.http_status == 502: - if cfg.debug_mode: - print( - Fore.RED + "Error: ", - "API Bad gateway. Waiting 20 seconds..." + Fore.RESET, - ) - time.sleep(20) + pass else: raise if attempt == num_retries - 1: raise - + if CFG.debug_mode: + print( + Fore.RED + "Error: ", + f"API Bad gateway. Waiting {backoff} seconds..." + Fore.RESET, + ) + time.sleep(backoff) if response is None: - raise RuntimeError("Failed to get response after 5 retries") + raise RuntimeError(f"Failed to get response after {num_retries} retries") return response.choices[0].message["content"] diff --git a/autogpt/logger.py b/autogpt/logs.py similarity index 59% rename from autogpt/logger.py rename to autogpt/logs.py index 1b58fdff65..a34d89b1b0 100644 --- a/autogpt/logger.py +++ b/autogpt/logs.py @@ -1,25 +1,28 @@ +"""Logging module for Auto-GPT.""" +import json import logging import os import random import re import time from logging import LogRecord +import traceback from colorama import Fore, Style -from autogpt import speak +from autogpt.speech import say_text from autogpt.config import Config, Singleton -cfg = Config() - -""" -Logger that handle titles in different colors. -Outputs logs in console, activity.log, and errors.log -For console handler: simulates typing -""" +CFG = Config() class Logger(metaclass=Singleton): + """ + Logger that handle titles in different colors. + Outputs logs in console, activity.log, and errors.log + For console handler: simulates typing + """ + def __init__(self): # create log directory if it doesn't exist this_files_dir_path = os.path.dirname(__file__) @@ -74,8 +77,8 @@ class Logger(metaclass=Singleton): def typewriter_log( self, title="", title_color="", content="", speak_text=False, level=logging.INFO ): - if speak_text and cfg.speak_mode: - speak.say_text(f"{title}. {content}") + if speak_text and CFG.speak_mode: + say_text(f"{title}. {content}") if content: if isinstance(content, list): @@ -193,3 +196,93 @@ def remove_color_codes(s: str) -> str: logger = Logger() + + +def print_assistant_thoughts(ai_name, assistant_reply): + """Prints the assistant's thoughts to the console""" + from autogpt.json_fixes.bracket_termination import ( + attempt_to_fix_json_by_finding_outermost_brackets, + ) + from autogpt.json_fixes.parsing import fix_and_parse_json + + try: + try: + # Parse and print Assistant response + assistant_reply_json = fix_and_parse_json(assistant_reply) + except json.JSONDecodeError: + logger.error("Error: Invalid JSON in assistant thoughts\n", assistant_reply) + assistant_reply_json = attempt_to_fix_json_by_finding_outermost_brackets( + assistant_reply + ) + if isinstance(assistant_reply_json, str): + assistant_reply_json = fix_and_parse_json(assistant_reply_json) + + # Check if assistant_reply_json is a string and attempt to parse + # it into a JSON object + if isinstance(assistant_reply_json, str): + try: + assistant_reply_json = json.loads(assistant_reply_json) + except json.JSONDecodeError: + logger.error("Error: Invalid JSON\n", assistant_reply) + assistant_reply_json = ( + attempt_to_fix_json_by_finding_outermost_brackets( + assistant_reply_json + ) + ) + + assistant_thoughts_reasoning = None + assistant_thoughts_plan = None + assistant_thoughts_speak = None + assistant_thoughts_criticism = None + if not isinstance(assistant_reply_json, dict): + assistant_reply_json = {} + assistant_thoughts = assistant_reply_json.get("thoughts", {}) + assistant_thoughts_text = assistant_thoughts.get("text") + + if assistant_thoughts: + assistant_thoughts_reasoning = assistant_thoughts.get("reasoning") + assistant_thoughts_plan = assistant_thoughts.get("plan") + assistant_thoughts_criticism = assistant_thoughts.get("criticism") + assistant_thoughts_speak = assistant_thoughts.get("speak") + + logger.typewriter_log( + f"{ai_name.upper()} THOUGHTS:", Fore.YELLOW, f"{assistant_thoughts_text}" + ) + logger.typewriter_log( + "REASONING:", Fore.YELLOW, f"{assistant_thoughts_reasoning}" + ) + + if assistant_thoughts_plan: + logger.typewriter_log("PLAN:", Fore.YELLOW, "") + # If it's a list, join it into a string + if isinstance(assistant_thoughts_plan, list): + assistant_thoughts_plan = "\n".join(assistant_thoughts_plan) + elif isinstance(assistant_thoughts_plan, dict): + assistant_thoughts_plan = str(assistant_thoughts_plan) + + # Split the input_string using the newline character and dashes + lines = assistant_thoughts_plan.split("\n") + for line in lines: + line = line.lstrip("- ") + logger.typewriter_log("- ", Fore.GREEN, line.strip()) + + logger.typewriter_log( + "CRITICISM:", Fore.YELLOW, f"{assistant_thoughts_criticism}" + ) + # Speak the assistant's thoughts + if CFG.speak_mode and assistant_thoughts_speak: + say_text(assistant_thoughts_speak) + + return assistant_reply_json + except json.decoder.JSONDecodeError: + logger.error("Error: Invalid JSON\n", assistant_reply) + if CFG.speak_mode: + say_text( + "I have received an invalid JSON response from the OpenAI API." + " I cannot ignore this response." + ) + + # All other errors, return "Error: + error message" + except Exception: + call_stack = traceback.format_exc() + logger.error("Error: \n", call_stack) diff --git a/autogpt/memory/local.py b/autogpt/memory/local.py index 67f040aed0..a5f6076ebb 100644 --- a/autogpt/memory/local.py +++ b/autogpt/memory/local.py @@ -1,6 +1,6 @@ import dataclasses import os -from typing import Any, List, Optional +from typing import Any, List, Optional, Tuple import numpy as np import orjson @@ -24,8 +24,17 @@ class CacheContent: class LocalCache(MemoryProviderSingleton): - # on load, load our database + """A class that stores the memory in a local file""" + def __init__(self, cfg) -> None: + """Initialize a class instance + + Args: + cfg: Config object + + Returns: + None + """ self.filename = f"{cfg.memory_index}.json" if os.path.exists(self.filename): try: @@ -42,7 +51,8 @@ class LocalCache(MemoryProviderSingleton): self.data = CacheContent() else: print( - f"Warning: The file '{self.filename}' does not exist. Local memory would not be saved to a file." + f"Warning: The file '{self.filename}' does not exist." + "Local memory would not be saved to a file." ) self.data = CacheContent() @@ -116,7 +126,7 @@ class LocalCache(MemoryProviderSingleton): return [self.data.texts[i] for i in top_k_indices] - def get_stats(self): + def get_stats(self) -> Tuple[int, Tuple[int, ...]]: """ Returns: The stats of the local cache. """ diff --git a/autogpt/memory/no_memory.py b/autogpt/memory/no_memory.py index 37f000850c..0a97669053 100644 --- a/autogpt/memory/no_memory.py +++ b/autogpt/memory/no_memory.py @@ -1,9 +1,14 @@ +"""A class that does not store any data. This is the default memory provider.""" from typing import Optional, List, Any from autogpt.memory.base import MemoryProviderSingleton class NoMemory(MemoryProviderSingleton): + """ + A class that does not store any data. This is the default memory provider. + """ + def __init__(self, cfg): """ Initializes the NoMemory provider. diff --git a/autogpt/memory/pinecone.py b/autogpt/memory/pinecone.py index 4e302f6e01..a7dbfa82a6 100644 --- a/autogpt/memory/pinecone.py +++ b/autogpt/memory/pinecone.py @@ -1,7 +1,7 @@ import pinecone from colorama import Fore, Style -from autogpt.logger import logger +from autogpt.logs import logger from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding @@ -16,7 +16,8 @@ class PineconeMemory(MemoryProviderSingleton): table_name = "auto-gpt" # this assumes we don't start with memory. # for now this works. - # we'll need a more complicated and robust system if we want to start with memory. + # we'll need a more complicated and robust system if we want to start with + # memory. self.vec_num = 0 try: @@ -28,8 +29,10 @@ class PineconeMemory(MemoryProviderSingleton): Style.BRIGHT + str(e) + Style.RESET_ALL, ) logger.double_check( - "Please ensure you have setup and configured Pinecone properly for use. " - + f"You can check out {Fore.CYAN + Style.BRIGHT}https://github.com/Torantulino/Auto-GPT#-pinecone-api-key-setup{Style.RESET_ALL} to ensure you've set up everything correctly." + "Please ensure you have setup and configured Pinecone properly for use." + + f"You can check out {Fore.CYAN + Style.BRIGHT}" + "https://github.com/Torantulino/Auto-GPT#-pinecone-api-key-setup" + f"{Style.RESET_ALL} to ensure you've set up everything correctly." ) exit(1) @@ -42,7 +45,7 @@ class PineconeMemory(MemoryProviderSingleton): def add(self, data): vector = get_ada_embedding(data) # no metadata here. We may wish to change that long term. - resp = self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) + self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) _text = f"Inserting data into memory at index: {self.vec_num}:\n data: {data}" self.vec_num += 1 return _text diff --git a/autogpt/memory/redismem.py b/autogpt/memory/redismem.py index d36594baef..df6d8fc04b 100644 --- a/autogpt/memory/redismem.py +++ b/autogpt/memory/redismem.py @@ -8,7 +8,7 @@ from redis.commands.search.field import TextField, VectorField from redis.commands.search.indexDefinition import IndexDefinition, IndexType from redis.commands.search.query import Query -from autogpt.logger import logger +from autogpt.logs import logger from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding SCHEMA = [ @@ -54,7 +54,9 @@ class RedisMemory(MemoryProviderSingleton): ) logger.double_check( "Please ensure you have setup and configured Redis properly for use. " - + f"You can check out {Fore.CYAN + Style.BRIGHT}https://github.com/Torantulino/Auto-GPT#redis-setup{Style.RESET_ALL} to ensure you've set up everything correctly." + + f"You can check out {Fore.CYAN + Style.BRIGHT}" + f"https://github.com/Torantulino/Auto-GPT#redis-setup{Style.RESET_ALL}" + " to ensure you've set up everything correctly." ) exit(1) diff --git a/autogpt/processing/__init__.py b/autogpt/processing/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/autogpt/processing/text.py b/autogpt/processing/text.py new file mode 100644 index 0000000000..24e3bb8581 --- /dev/null +++ b/autogpt/processing/text.py @@ -0,0 +1,132 @@ +"""Text processing functions""" +from typing import Generator, Optional +from selenium.webdriver.remote.webdriver import WebDriver +from autogpt.memory import get_memory +from autogpt.config import Config +from autogpt.llm_utils import create_chat_completion + +CFG = Config() +MEMORY = get_memory(CFG) + + +def split_text(text: str, max_length: int = 8192) -> Generator[str, None, None]: + """Split text into chunks of a maximum length + + Args: + text (str): The text to split + max_length (int, optional): The maximum length of each chunk. Defaults to 8192. + + Yields: + str: The next chunk of text + + Raises: + ValueError: If the text is longer than the maximum length + """ + paragraphs = text.split("\n") + current_length = 0 + current_chunk = [] + + for paragraph in paragraphs: + if current_length + len(paragraph) + 1 <= max_length: + current_chunk.append(paragraph) + current_length += len(paragraph) + 1 + else: + yield "\n".join(current_chunk) + current_chunk = [paragraph] + current_length = len(paragraph) + 1 + + if current_chunk: + yield "\n".join(current_chunk) + + +def summarize_text( + url: str, text: str, question: str, driver: Optional[WebDriver] = None +) -> str: + """Summarize text using the OpenAI API + + Args: + url (str): The url of the text + text (str): The text to summarize + question (str): The question to ask the model + driver (WebDriver): The webdriver to use to scroll the page + + Returns: + str: The summary of the text + """ + if not text: + return "Error: No text to summarize" + + text_length = len(text) + print(f"Text length: {text_length} characters") + + summaries = [] + chunks = list(split_text(text)) + scroll_ratio = 1 / len(chunks) + + for i, chunk in enumerate(chunks): + if driver: + scroll_to_percentage(driver, scroll_ratio * i) + print(f"Adding chunk {i + 1} / {len(chunks)} to memory") + + memory_to_add = f"Source: {url}\n" f"Raw content part#{i + 1}: {chunk}" + + MEMORY.add(memory_to_add) + + print(f"Summarizing chunk {i + 1} / {len(chunks)}") + messages = [create_message(chunk, question)] + + summary = create_chat_completion( + model=CFG.fast_llm_model, + messages=messages, + max_tokens=CFG.browse_summary_max_token, + ) + summaries.append(summary) + print(f"Added chunk {i + 1} summary to memory") + + memory_to_add = f"Source: {url}\n" f"Content summary part#{i + 1}: {summary}" + + MEMORY.add(memory_to_add) + + print(f"Summarized {len(chunks)} chunks.") + + combined_summary = "\n".join(summaries) + messages = [create_message(combined_summary, question)] + + return create_chat_completion( + model=CFG.fast_llm_model, + messages=messages, + max_tokens=CFG.browse_summary_max_token, + ) + + +def scroll_to_percentage(driver: WebDriver, ratio: float) -> None: + """Scroll to a percentage of the page + + Args: + driver (WebDriver): The webdriver to use + ratio (float): The percentage to scroll to + + Raises: + ValueError: If the ratio is not between 0 and 1 + """ + if ratio < 0 or ratio > 1: + raise ValueError("Percentage should be between 0 and 1") + driver.execute_script(f"window.scrollTo(0, document.body.scrollHeight * {ratio});") + + +def create_message(chunk: str, question: str) -> dict[str, str]: + """Create a message for the chat completion + + Args: + chunk (str): The chunk of text to summarize + question (str): The question to answer + + Returns: + dict[str, str]: The message to send to the chat completion + """ + return { + "role": "user", + "content": f'"""{chunk}""" Using the above text, please answer the following' + f' question: "{question}" -- if the question cannot be answered using the text,' + " please summarize the text.", + } diff --git a/autogpt/prompt.py b/autogpt/prompt.py index e41312c7da..050c2560de 100644 --- a/autogpt/prompt.py +++ b/autogpt/prompt.py @@ -1,4 +1,12 @@ +from colorama import Fore +from autogpt.config.ai_config import AIConfig +from autogpt.config.config import Config +from autogpt.logs import logger from autogpt.promptgenerator import PromptGenerator +from autogpt.setup import prompt_user +from autogpt.utils import clean_input + +CFG = Config() def get_prompt() -> str: @@ -106,3 +114,42 @@ def get_prompt() -> str: # Generate the prompt string return prompt_generator.generate_prompt_string() + + +def construct_prompt() -> str: + """Construct the prompt for the AI to respond to + + Returns: + str: The prompt string + """ + config = AIConfig.load(CFG.ai_settings_file) + if CFG.skip_reprompt and config.ai_name: + logger.typewriter_log("Name :", Fore.GREEN, config.ai_name) + logger.typewriter_log("Role :", Fore.GREEN, config.ai_role) + logger.typewriter_log("Goals:", Fore.GREEN, f"{config.ai_goals}") + elif config.ai_name: + logger.typewriter_log( + "Welcome back! ", + Fore.GREEN, + f"Would you like me to return to being {config.ai_name}?", + speak_text=True, + ) + should_continue = clean_input( + f"""Continue with the last settings? +Name: {config.ai_name} +Role: {config.ai_role} +Goals: {config.ai_goals} +Continue (y/n): """ + ) + if should_continue.lower() == "n": + config = AIConfig() + + if not config.ai_name: + config = prompt_user() + config.save() + + # Get rid of this global: + global ai_name + ai_name = config.ai_name + + return config.construct_full_prompt() diff --git a/autogpt/promptgenerator.py b/autogpt/promptgenerator.py index d6802cec2b..82dba8e022 100644 --- a/autogpt/promptgenerator.py +++ b/autogpt/promptgenerator.py @@ -1,4 +1,6 @@ +""" A module for generating custom prompt strings.""" import json +from typing import Any, Dict, List class PromptGenerator: @@ -7,7 +9,7 @@ class PromptGenerator: resources, and performance evaluations. """ - def __init__(self): + def __init__(self) -> None: """ Initialize the PromptGenerator object with empty lists of constraints, commands, resources, and performance evaluations. @@ -27,7 +29,7 @@ class PromptGenerator: "command": {"name": "command name", "args": {"arg name": "value"}}, } - def add_constraint(self, constraint): + def add_constraint(self, constraint: str) -> None: """ Add a constraint to the constraints list. @@ -36,7 +38,7 @@ class PromptGenerator: """ self.constraints.append(constraint) - def add_command(self, command_label, command_name, args=None): + def add_command(self, command_label: str, command_name: str, args=None) -> None: """ Add a command to the commands list with a label, name, and optional arguments. @@ -59,7 +61,7 @@ class PromptGenerator: self.commands.append(command) - def _generate_command_string(self, command): + def _generate_command_string(self, command: Dict[str, Any]) -> str: """ Generate a formatted string representation of a command. @@ -92,7 +94,7 @@ class PromptGenerator: """ self.performance_evaluation.append(evaluation) - def _generate_numbered_list(self, items, item_type="list") -> str: + def _generate_numbered_list(self, items: List[Any], item_type="list") -> str: """ Generate a numbered list from given items based on the item_type. diff --git a/autogpt/setup.py b/autogpt/setup.py new file mode 100644 index 0000000000..5315c01db0 --- /dev/null +++ b/autogpt/setup.py @@ -0,0 +1,69 @@ +"""Setup the AI and its goals""" +from colorama import Fore, Style +from autogpt import utils +from autogpt.config.ai_config import AIConfig +from autogpt.logs import logger + + +def prompt_user() -> AIConfig: + """Prompt the user for input + + Returns: + AIConfig: The AIConfig object containing the user's input + """ + ai_name = "" + # Construct the prompt + logger.typewriter_log( + "Welcome to Auto-GPT! ", + Fore.GREEN, + "Enter the name of your AI and its role below. Entering nothing will load" + " defaults.", + speak_text=True, + ) + + # Get AI Name from User + logger.typewriter_log( + "Name your AI: ", Fore.GREEN, "For example, 'Entrepreneur-GPT'" + ) + ai_name = utils.clean_input("AI Name: ") + if ai_name == "": + ai_name = "Entrepreneur-GPT" + + logger.typewriter_log( + f"{ai_name} here!", Fore.LIGHTBLUE_EX, "I am at your service.", speak_text=True + ) + + # Get AI Role from User + logger.typewriter_log( + "Describe your AI's role: ", + Fore.GREEN, + "For example, 'an AI designed to autonomously develop and run businesses with" + " the sole goal of increasing your net worth.'", + ) + ai_role = utils.clean_input(f"{ai_name} is: ") + if ai_role == "": + ai_role = "an AI designed to autonomously develop and run businesses with the" + " sole goal of increasing your net worth." + + # Enter up to 5 goals for the AI + logger.typewriter_log( + "Enter up to 5 goals for your AI: ", + Fore.GREEN, + "For example: \nIncrease net worth, Grow Twitter Account, Develop and manage" + " multiple businesses autonomously'", + ) + print("Enter nothing to load defaults, enter nothing when finished.", flush=True) + ai_goals = [] + for i in range(5): + ai_goal = utils.clean_input(f"{Fore.LIGHTBLUE_EX}Goal{Style.RESET_ALL} {i+1}: ") + if ai_goal == "": + break + ai_goals.append(ai_goal) + if not ai_goals: + ai_goals = [ + "Increase net worth", + "Grow Twitter Account", + "Develop and manage multiple businesses autonomously", + ] + + return AIConfig(ai_name, ai_role, ai_goals) diff --git a/autogpt/speak.py b/autogpt/speak.py deleted file mode 100644 index 41b3ac9f3b..0000000000 --- a/autogpt/speak.py +++ /dev/null @@ -1,120 +0,0 @@ -import os - -import requests -from playsound import playsound - -from autogpt.config import Config - -import threading -from threading import Lock, Semaphore - -import gtts - -cfg = Config() - -# Default voice IDs -default_voices = ["ErXwobaYiN019PkySvjV", "EXAVITQu4vr4xnSDxMaL"] - -# Retrieve custom voice IDs from the Config class -custom_voice_1 = cfg.elevenlabs_voice_1_id -custom_voice_2 = cfg.elevenlabs_voice_2_id - -# Placeholder values that should be treated as empty -placeholders = {"your-voice-id"} - -# Use custom voice IDs if provided and not placeholders, otherwise use default voice IDs -voices = [ - custom_voice_1 - if custom_voice_1 and custom_voice_1 not in placeholders - else default_voices[0], - custom_voice_2 - if custom_voice_2 and custom_voice_2 not in placeholders - else default_voices[1], -] - -tts_headers = {"Content-Type": "application/json", "xi-api-key": cfg.elevenlabs_api_key} - -mutex_lock = Lock() # Ensure only one sound is played at a time -queue_semaphore = Semaphore( - 1 -) # The amount of sounds to queue before blocking the main thread - - -def eleven_labs_speech(text, voice_index=0): - """Speak text using elevenlabs.io's API""" - tts_url = "https://api.elevenlabs.io/v1/text-to-speech/{voice_id}".format( - voice_id=voices[voice_index] - ) - formatted_message = {"text": text} - response = requests.post(tts_url, headers=tts_headers, json=formatted_message) - - if response.status_code == 200: - with mutex_lock: - with open("speech.mpeg", "wb") as f: - f.write(response.content) - playsound("speech.mpeg", True) - os.remove("speech.mpeg") - return True - else: - print("Request failed with status code:", response.status_code) - print("Response content:", response.content) - return False - - -def brian_speech(text): - """Speak text using Brian with the streamelements API""" - tts_url = f"https://api.streamelements.com/kappa/v2/speech?voice=Brian&text={text}" - response = requests.get(tts_url) - - if response.status_code == 200: - with mutex_lock: - with open("speech.mp3", "wb") as f: - f.write(response.content) - playsound("speech.mp3") - os.remove("speech.mp3") - return True - else: - print("Request failed with status code:", response.status_code) - print("Response content:", response.content) - return False - - -def gtts_speech(text): - tts = gtts.gTTS(text) - with mutex_lock: - tts.save("speech.mp3") - playsound("speech.mp3", True) - os.remove("speech.mp3") - - -def macos_tts_speech(text, voice_index=0): - if voice_index == 0: - os.system(f'say "{text}"') - else: - if voice_index == 1: - os.system(f'say -v "Ava (Premium)" "{text}"') - else: - os.system(f'say -v Samantha "{text}"') - - -def say_text(text, voice_index=0): - def speak(): - if not cfg.elevenlabs_api_key: - if cfg.use_mac_os_tts == "True": - macos_tts_speech(text) - elif cfg.use_brian_tts == "True": - success = brian_speech(text) - if not success: - gtts_speech(text) - else: - gtts_speech(text) - else: - success = eleven_labs_speech(text, voice_index) - if not success: - gtts_speech(text) - - queue_semaphore.release() - - queue_semaphore.acquire(True) - thread = threading.Thread(target=speak) - thread.start() diff --git a/autogpt/speech/__init__.py b/autogpt/speech/__init__.py new file mode 100644 index 0000000000..2ff0d2bf48 --- /dev/null +++ b/autogpt/speech/__init__.py @@ -0,0 +1,4 @@ +"""This module contains the speech recognition and speech synthesis functions.""" +from autogpt.speech.say import say_text + +__all__ = ["say_text"] diff --git a/autogpt/speech/base.py b/autogpt/speech/base.py new file mode 100644 index 0000000000..d74fa51be7 --- /dev/null +++ b/autogpt/speech/base.py @@ -0,0 +1,50 @@ +"""Base class for all voice classes.""" +import abc +from threading import Lock + +from autogpt.config import AbstractSingleton + + +class VoiceBase(AbstractSingleton): + """ + Base class for all voice classes. + """ + + def __init__(self): + """ + Initialize the voice class. + """ + self._url = None + self._headers = None + self._api_key = None + self._voices = [] + self._mutex = Lock() + self._setup() + + def say(self, text: str, voice_index: int = 0) -> bool: + """ + Say the given text. + + Args: + text (str): The text to say. + voice_index (int): The index of the voice to use. + """ + with self._mutex: + return self._speech(text, voice_index) + + @abc.abstractmethod + def _setup(self) -> None: + """ + Setup the voices, API key, etc. + """ + pass + + @abc.abstractmethod + def _speech(self, text: str, voice_index: int = 0) -> bool: + """ + Play the given text. + + Args: + text (str): The text to play. + """ + pass diff --git a/autogpt/speech/brian.py b/autogpt/speech/brian.py new file mode 100644 index 0000000000..e581bbcc8d --- /dev/null +++ b/autogpt/speech/brian.py @@ -0,0 +1,39 @@ +""" Brian speech module for autogpt """ +import os +import requests +from playsound import playsound + +from autogpt.speech.base import VoiceBase + + +class BrianSpeech(VoiceBase): + """Brian speech module for autogpt""" + + def _setup(self) -> None: + """Setup the voices, API key, etc.""" + pass + + def _speech(self, text: str) -> bool: + """Speak text using Brian with the streamelements API + + Args: + text (str): The text to speak + + Returns: + bool: True if the request was successful, False otherwise + """ + tts_url = ( + f"https://api.streamelements.com/kappa/v2/speech?voice=Brian&text={text}" + ) + response = requests.get(tts_url) + + if response.status_code == 200: + with open("speech.mp3", "wb") as f: + f.write(response.content) + playsound("speech.mp3") + os.remove("speech.mp3") + return True + else: + print("Request failed with status code:", response.status_code) + print("Response content:", response.content) + return False diff --git a/autogpt/speech/eleven_labs.py b/autogpt/speech/eleven_labs.py new file mode 100644 index 0000000000..2c54ffad18 --- /dev/null +++ b/autogpt/speech/eleven_labs.py @@ -0,0 +1,71 @@ +"""ElevenLabs speech module""" +import os +from playsound import playsound + +import requests + +from autogpt.config import Config +from autogpt.speech.base import VoiceBase + +PLACEHOLDERS = {"your-voice-id"} + + +class ElevenLabsSpeech(VoiceBase): + """ElevenLabs speech class""" + + def _setup(self) -> None: + """Setup the voices, API key, etc. + + Returns: + None: None + """ + + cfg = Config() + default_voices = ["ErXwobaYiN019PkySvjV", "EXAVITQu4vr4xnSDxMaL"] + self._headers = { + "Content-Type": "application/json", + "xi-api-key": cfg.elevenlabs_api_key, + } + self._voices = default_voices.copy() + self._use_custom_voice(cfg.elevenlabs_voice_1_id, 0) + self._use_custom_voice(cfg.elevenlabs_voice_2_id, 1) + + def _use_custom_voice(self, voice, voice_index) -> None: + """Use a custom voice if provided and not a placeholder + + Args: + voice (str): The voice ID + voice_index (int): The voice index + + Returns: + None: None + """ + # Placeholder values that should be treated as empty + if voice and voice not in PLACEHOLDERS: + self._voices[voice_index] = voice + + def _speech(self, text: str, voice_index: int = 0) -> bool: + """Speak text using elevenlabs.io's API + + Args: + text (str): The text to speak + voice_index (int, optional): The voice to use. Defaults to 0. + + Returns: + bool: True if the request was successful, False otherwise + """ + tts_url = ( + f"https://api.elevenlabs.io/v1/text-to-speech/{self._voices[voice_index]}" + ) + response = requests.post(tts_url, headers=self._headers, json={"text": text}) + + if response.status_code == 200: + with open("speech.mpeg", "wb") as f: + f.write(response.content) + playsound("speech.mpeg", True) + os.remove("speech.mpeg") + return True + else: + print("Request failed with status code:", response.status_code) + print("Response content:", response.content) + return False diff --git a/autogpt/speech/gtts.py b/autogpt/speech/gtts.py new file mode 100644 index 0000000000..37497075e7 --- /dev/null +++ b/autogpt/speech/gtts.py @@ -0,0 +1,21 @@ +""" GTTS Voice. """ +import os +from playsound import playsound +import gtts + +from autogpt.speech.base import VoiceBase + + +class GTTSVoice(VoiceBase): + """GTTS Voice.""" + + def _setup(self) -> None: + pass + + def _speech(self, text: str, _: int = 0) -> bool: + """Play the given text.""" + tts = gtts.gTTS(text) + tts.save("speech.mp3") + playsound("speech.mp3", True) + os.remove("speech.mp3") + return True diff --git a/autogpt/speech/macos_tts.py b/autogpt/speech/macos_tts.py new file mode 100644 index 0000000000..4c072ce256 --- /dev/null +++ b/autogpt/speech/macos_tts.py @@ -0,0 +1,21 @@ +""" MacOS TTS Voice. """ +import os + +from autogpt.speech.base import VoiceBase + + +class MacOSTTS(VoiceBase): + """MacOS TTS Voice.""" + + def _setup(self) -> None: + pass + + def _speech(self, text: str, voice_index: int = 0) -> bool: + """Play the given text.""" + if voice_index == 0: + os.system(f'say "{text}"') + elif voice_index == 1: + os.system(f'say -v "Ava (Premium)" "{text}"') + else: + os.system(f'say -v Samantha "{text}"') + return True diff --git a/autogpt/speech/say.py b/autogpt/speech/say.py new file mode 100644 index 0000000000..78b75b21fc --- /dev/null +++ b/autogpt/speech/say.py @@ -0,0 +1,42 @@ +""" Text to speech module """ +from autogpt.config import Config + +import threading +from threading import Semaphore +from autogpt.speech.brian import BrianSpeech +from autogpt.speech.macos_tts import MacOSTTS +from autogpt.speech.gtts import GTTSVoice +from autogpt.speech.eleven_labs import ElevenLabsSpeech + + +CFG = Config() +DEFAULT_VOICE_ENGINE = GTTSVoice() +VOICE_ENGINE = None +if CFG.elevenlabs_api_key: + VOICE_ENGINE = ElevenLabsSpeech() +elif CFG.use_mac_os_tts == "True": + VOICE_ENGINE = MacOSTTS() +elif CFG.use_brian_tts == "True": + VOICE_ENGINE = BrianSpeech() +else: + VOICE_ENGINE = GTTSVoice() + + +QUEUE_SEMAPHORE = Semaphore( + 1 +) # The amount of sounds to queue before blocking the main thread + + +def say_text(text: str, voice_index: int = 0) -> None: + """Speak the given text using the given voice index""" + + def speak() -> None: + success = VOICE_ENGINE.say(text, voice_index) + if not success: + DEFAULT_VOICE_ENGINE.say(text) + + QUEUE_SEMAPHORE.release() + + QUEUE_SEMAPHORE.acquire(True) + thread = threading.Thread(target=speak) + thread.start() diff --git a/autogpt/spinner.py b/autogpt/spinner.py index 65679d5665..56b4f20a68 100644 --- a/autogpt/spinner.py +++ b/autogpt/spinner.py @@ -1,3 +1,4 @@ +"""A simple spinner module""" import itertools import sys import threading @@ -7,15 +8,20 @@ import time class Spinner: """A simple spinner class""" - def __init__(self, message="Loading...", delay=0.1): - """Initialize the spinner class""" + def __init__(self, message: str = "Loading...", delay: float = 0.1) -> None: + """Initialize the spinner class + + Args: + message (str): The message to display. + delay (float): The delay between each spinner update. + """ self.spinner = itertools.cycle(["-", "/", "|", "\\"]) self.delay = delay self.message = message self.running = False self.spinner_thread = None - def spin(self): + def spin(self) -> None: """Spin the spinner""" while self.running: sys.stdout.write(f"{next(self.spinner)} {self.message}\r") @@ -23,14 +29,20 @@ class Spinner: time.sleep(self.delay) sys.stdout.write(f"\r{' ' * (len(self.message) + 2)}\r") - def __enter__(self): + def __enter__(self) -> None: """Start the spinner""" self.running = True self.spinner_thread = threading.Thread(target=self.spin) self.spinner_thread.start() - def __exit__(self, exc_type, exc_value, exc_traceback): - """Stop the spinner""" + def __exit__(self, exc_type, exc_value, exc_traceback) -> None: + """Stop the spinner + + Args: + exc_type (Exception): The exception type. + exc_value (Exception): The exception value. + exc_traceback (Exception): The exception traceback. + """ self.running = False if self.spinner_thread is not None: self.spinner_thread.join() diff --git a/autogpt/summary.py b/autogpt/summary.py deleted file mode 100644 index 38f0aadc4e..0000000000 --- a/autogpt/summary.py +++ /dev/null @@ -1,69 +0,0 @@ -from autogpt.llm_utils import create_chat_completion - - -def summarize_text(driver, text, question): - if not text: - return "Error: No text to summarize" - - text_length = len(text) - print(f"Text length: {text_length} characters") - - summaries = [] - chunks = list(split_text(text)) - - scroll_ratio = 1 / len(chunks) - for i, chunk in enumerate(chunks): - scroll_to_percentage(driver, scroll_ratio * i) - print(f"Summarizing chunk {i + 1} / {len(chunks)}") - messages = [create_message(chunk, question)] - - summary = create_chat_completion( - model="gpt-3.5-turbo", - messages=messages, - max_tokens=300, - ) - summaries.append(summary) - - print(f"Summarized {len(chunks)} chunks.") - - combined_summary = "\n".join(summaries) - messages = [create_message(combined_summary, question)] - - return create_chat_completion( - model="gpt-3.5-turbo", - messages=messages, - max_tokens=300, - ) - - -def split_text(text, max_length=8192): - paragraphs = text.split("\n") - current_length = 0 - current_chunk = [] - - for paragraph in paragraphs: - if current_length + len(paragraph) + 1 <= max_length: - current_chunk.append(paragraph) - current_length += len(paragraph) + 1 - else: - yield "\n".join(current_chunk) - current_chunk = [paragraph] - current_length = len(paragraph) + 1 - - if current_chunk: - yield "\n".join(current_chunk) - - -def create_message(chunk, question): - return { - "role": "user", - "content": f'"""{chunk}""" Using the above text, please answer the following' - f' question: "{question}" -- if the question cannot be answered using the text,' - " please summarize the text.", - } - - -def scroll_to_percentage(driver, ratio): - if ratio < 0 or ratio > 1: - raise ValueError("Percentage should be between 0 and 1") - driver.execute_script(f"window.scrollTo(0, document.body.scrollHeight * {ratio});") diff --git a/autogpt/token_counter.py b/autogpt/token_counter.py index 875e8d42ea..c12397221f 100644 --- a/autogpt/token_counter.py +++ b/autogpt/token_counter.py @@ -1,8 +1,9 @@ +"""Functions for counting the number of tokens in a message or string.""" from typing import Dict, List import tiktoken -from autogpt.logger import logger +from autogpt.logs import logger def count_message_tokens( @@ -12,13 +13,13 @@ def count_message_tokens( Returns the number of tokens used by a list of messages. Args: - messages (list): A list of messages, each of which is a dictionary - containing the role and content of the message. - model (str): The name of the model to use for tokenization. - Defaults to "gpt-3.5-turbo-0301". + messages (list): A list of messages, each of which is a dictionary + containing the role and content of the message. + model (str): The name of the model to use for tokenization. + Defaults to "gpt-3.5-turbo-0301". Returns: - int: The number of tokens used by the list of messages. + int: The number of tokens used by the list of messages. """ try: encoding = tiktoken.encoding_for_model(model) @@ -62,11 +63,11 @@ def count_string_tokens(string: str, model_name: str) -> int: Returns the number of tokens in a text string. Args: - string (str): The text string. - model_name (str): The name of the encoding to use. (e.g., "gpt-3.5-turbo") + string (str): The text string. + model_name (str): The name of the encoding to use. (e.g., "gpt-3.5-turbo") Returns: - int: The number of tokens in the text string. + int: The number of tokens in the text string. """ encoding = tiktoken.encoding_for_model(model_name) return len(encoding.encode(string)) diff --git a/autogpt/web.py b/autogpt/web.py deleted file mode 100644 index 355f7fd39b..0000000000 --- a/autogpt/web.py +++ /dev/null @@ -1,85 +0,0 @@ -from selenium import webdriver -import autogpt.summary as summary -from bs4 import BeautifulSoup -from selenium.webdriver.common.by import By -from selenium.webdriver.support.wait import WebDriverWait -from selenium.webdriver.support import expected_conditions as EC -from webdriver_manager.chrome import ChromeDriverManager -from selenium.webdriver.chrome.options import Options -import logging -from pathlib import Path -from autogpt.config import Config - -file_dir = Path(__file__).parent -cfg = Config() - - -def browse_website(url, question): - driver, text = scrape_text_with_selenium(url) - add_header(driver) - summary_text = summary.summarize_text(driver, text, question) - links = scrape_links_with_selenium(driver) - - # Limit links to 5 - if len(links) > 5: - links = links[:5] - close_browser(driver) - return f"Answer gathered from website: {summary_text} \n \n Links: {links}", driver - - -def scrape_text_with_selenium(url): - logging.getLogger("selenium").setLevel(logging.CRITICAL) - - options = Options() - options.add_argument( - "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" - ) - driver = webdriver.Chrome( - executable_path=ChromeDriverManager().install(), options=options - ) - driver.get(url) - - WebDriverWait(driver, 10).until( - EC.presence_of_element_located((By.TAG_NAME, "body")) - ) - - # Get the HTML content directly from the browser's DOM - page_source = driver.execute_script("return document.body.outerHTML;") - soup = BeautifulSoup(page_source, "html.parser") - - for script in soup(["script", "style"]): - script.extract() - - text = soup.get_text() - lines = (line.strip() for line in text.splitlines()) - chunks = (phrase.strip() for line in lines for phrase in line.split(" ")) - text = "\n".join(chunk for chunk in chunks if chunk) - return driver, text - - -def scrape_links_with_selenium(driver): - page_source = driver.page_source - soup = BeautifulSoup(page_source, "html.parser") - - for script in soup(["script", "style"]): - script.extract() - - hyperlinks = extract_hyperlinks(soup) - - return format_hyperlinks(hyperlinks) - - -def close_browser(driver): - driver.quit() - - -def extract_hyperlinks(soup): - return [(link.text, link["href"]) for link in soup.find_all("a", href=True)] - - -def format_hyperlinks(hyperlinks): - return [f"{link_text} ({link_url})" for link_text, link_url in hyperlinks] - - -def add_header(driver): - driver.execute_script(open(f"{file_dir}/js/overlay.js", "r").read()) diff --git a/scripts/main.py b/scripts/main.py deleted file mode 100644 index b6871d1cea..0000000000 --- a/scripts/main.py +++ /dev/null @@ -1,11 +0,0 @@ -from colorama import Style, init - -# Initialize colorama -init(autoreset=True) - -# Use the bold ANSI style -print( - f"""{Style.BRIGHT}Please run: -python -m autogpt -""" -) diff --git a/tests/test_json_parser.py b/tests/test_json_parser.py index 7e3d4f51a8..2862034b3f 100644 --- a/tests/test_json_parser.py +++ b/tests/test_json_parser.py @@ -1,7 +1,7 @@ import unittest import tests.context -from autogpt.json_parser import fix_and_parse_json +from autogpt.json_fixes.parsing import fix_and_parse_json class TestParseJson(unittest.TestCase): diff --git a/tests/unit/test_browse_scrape_text.py b/tests/unit/test_browse_scrape_text.py index be075ad745..98f5f558ab 100644 --- a/tests/unit/test_browse_scrape_text.py +++ b/tests/unit/test_browse_scrape_text.py @@ -2,7 +2,7 @@ import requests -from autogpt.browse import scrape_text +from autogpt.commands.web_requests import scrape_text """ Code Analysis From bdefa24ac6adcc810ff144bd62b08a0d0e6b9c40 Mon Sep 17 00:00:00 2001 From: Drikus Roor Date: Sat, 15 Apr 2023 14:50:54 +0200 Subject: [PATCH 14/24] test: Write unit tests for token_counter --- autogpt/token_counter.py | 2 +- tests/test_token_counter.py | 61 +++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 tests/test_token_counter.py diff --git a/autogpt/token_counter.py b/autogpt/token_counter.py index c12397221f..a85a54be0e 100644 --- a/autogpt/token_counter.py +++ b/autogpt/token_counter.py @@ -27,7 +27,7 @@ def count_message_tokens( logger.warn("Warning: model not found. Using cl100k_base encoding.") encoding = tiktoken.get_encoding("cl100k_base") if model == "gpt-3.5-turbo": - # !Node: gpt-3.5-turbo may change over time. + # !Note: gpt-3.5-turbo may change over time. # Returning num tokens assuming gpt-3.5-turbo-0301.") return count_message_tokens(messages, model="gpt-3.5-turbo-0301") elif model == "gpt-4": diff --git a/tests/test_token_counter.py b/tests/test_token_counter.py new file mode 100644 index 0000000000..d13f2ae02a --- /dev/null +++ b/tests/test_token_counter.py @@ -0,0 +1,61 @@ +import unittest +import tests.context + +from scripts.token_counter import count_message_tokens, count_string_tokens + +class TestTokenCounter(unittest.TestCase): + + def test_count_message_tokens(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + self.assertEqual(count_message_tokens(messages), 17) + + def test_count_message_tokens_with_name(self): + messages = [ + {"role": "user", "content": "Hello", "name": "John"}, + {"role": "assistant", "content": "Hi there!"} + ] + self.assertEqual(count_message_tokens(messages), 17) + + def test_count_message_tokens_empty_input(self): + self.assertEqual(count_message_tokens([]), 3) + + def test_count_message_tokens_invalid_model(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + with self.assertRaises(KeyError): + count_message_tokens(messages, model="invalid_model") + + def test_count_message_tokens_gpt_4(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + self.assertEqual(count_message_tokens(messages, model="gpt-4-0314"), 15) + + def test_count_string_tokens(self): + string = "Hello, world!" + self.assertEqual(count_string_tokens(string, model_name="gpt-3.5-turbo-0301"), 4) + + def test_count_string_tokens_empty_input(self): + self.assertEqual(count_string_tokens("", model_name="gpt-3.5-turbo-0301"), 0) + + def test_count_message_tokens_invalid_model(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + with self.assertRaises(NotImplementedError): + count_message_tokens(messages, model="invalid_model") + + def test_count_string_tokens_gpt_4(self): + string = "Hello, world!" + self.assertEqual(count_string_tokens(string, model_name="gpt-4-0314"), 4) + + +if __name__ == '__main__': + unittest.main() From d52381eead2f4ae8d5db3ca2e747a6c5e3dc1cea Mon Sep 17 00:00:00 2001 From: Drikus Roor Date: Sat, 15 Apr 2023 15:20:19 +0200 Subject: [PATCH 15/24] fix: Fix imports --- tests/test_token_counter.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_token_counter.py b/tests/test_token_counter.py index d13f2ae02a..42670e60c3 100644 --- a/tests/test_token_counter.py +++ b/tests/test_token_counter.py @@ -1,7 +1,7 @@ import unittest import tests.context +from autogpt.token_counter import count_message_tokens, count_string_tokens -from scripts.token_counter import count_message_tokens, count_string_tokens class TestTokenCounter(unittest.TestCase): From 395d9d048128d3008b36d79a9952c8a29bc0aad0 Mon Sep 17 00:00:00 2001 From: chyezh Date: Tue, 11 Apr 2023 19:36:41 +0800 Subject: [PATCH 16/24] enable milvus as memory backend --- .env.template | 7 +++ README.md | 38 ++++++++++++---- autogpt/config/config.py | 4 ++ autogpt/memory/__init__.py | 14 +++++- requirements.txt | 1 + scripts/memory/milvus.py | 90 ++++++++++++++++++++++++++++++++++++++ 6 files changed, 145 insertions(+), 9 deletions(-) create mode 100644 scripts/memory/milvus.py diff --git a/.env.template b/.env.template index 22bf8d74d9..b8140dd84c 100644 --- a/.env.template +++ b/.env.template @@ -77,6 +77,13 @@ REDIS_PASSWORD= WIPE_REDIS_ON_START=False MEMORY_INDEX=auto-gpt +### MILVUS +# MILVUS_ADDR - Milvus remote address (e.g. localhost:19530) +# MILVUS_COLLECTION - Milvus collection, +# change it if you want to start a new memory and retain the old memory. +MILVUS_ADDR=your-milvus-cluster-host-port +MILVUS_COLLECTION=autogpt + ################################################################################ ### IMAGE GENERATION PROVIDER ################################################################################ diff --git a/README.md b/README.md index ba42177433..00bb0ea391 100644 --- a/README.md +++ b/README.md @@ -35,22 +35,27 @@ Your support is greatly appreciated ## Table of Contents - [Auto-GPT: An Autonomous GPT-4 Experiment](#auto-gpt-an-autonomous-gpt-4-experiment) - - [Demo (30/03/2023):](#demo-30032023) + - [🔴 🔴 🔴 Urgent: USE `stable` not `master` 🔴 🔴 🔴](#----urgent-use-stable-not-master----) + - [Demo (30/03/2023):](#demo-30032023) - [Table of Contents](#table-of-contents) - [🚀 Features](#-features) - [📋 Requirements](#-requirements) - [💾 Installation](#-installation) - [🔧 Usage](#-usage) - [Logs](#logs) + - [Docker](#docker) + - [Command Line Arguments](#command-line-arguments) - [🗣️ Speech Mode](#️-speech-mode) - [🔍 Google API Keys Configuration](#-google-api-keys-configuration) - [Setting up environment variables](#setting-up-environment-variables) - - [Redis Setup](#redis-setup) - - [🌲 Pinecone API Key Setup](#-pinecone-api-key-setup) + - [Memory Backend Setup](#memory-backend-setup) + - [Redis Setup](#redis-setup) + - [🌲 Pinecone API Key Setup](#-pinecone-api-key-setup) + - [Milvus Setup](#milvus-setup) - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [🧠 Memory pre-seeding](#memory-pre-seeding) + - [🧠 Memory pre-seeding](#-memory-pre-seeding) - [💀 Continuous Mode ⚠️](#-continuous-mode-️) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [🖼 Image Generation](#-image-generation) @@ -75,10 +80,11 @@ Your support is greatly appreciated - [Python 3.8 or later](https://www.tutorialspoint.com/how-to-install-python-in-windows) - [OpenAI API key](https://platform.openai.com/account/api-keys) - Optional: -- [PINECONE API key](https://www.pinecone.io/) (If you want Pinecone backed memory) +- Memory backend + - [PINECONE API key](https://www.pinecone.io/) (If you want Pinecone backed memory) + - [Milvus](https://milvus.io/) (If you want Milvus as memory backend) - ElevenLabs Key (If you want the AI to speak) ## 💾 Installation @@ -209,7 +215,11 @@ export CUSTOM_SEARCH_ENGINE_ID="YOUR_CUSTOM_SEARCH_ENGINE_ID" ``` -## Redis Setup +## Memory Backend Setup + +Setup any one backend to persist memory. + +### Redis Setup Install docker desktop. @@ -246,7 +256,7 @@ You can specify the memory index for redis using the following: MEMORY_INDEX=whatever ``` -## 🌲 Pinecone API Key Setup +### 🌲 Pinecone API Key Setup Pinecone enables the storage of vast amounts of vector-based memory, allowing for only relevant memories to be loaded for the agent at any given time. @@ -254,6 +264,18 @@ Pinecone enables the storage of vast amounts of vector-based memory, allowing fo 2. Choose the `Starter` plan to avoid being charged. 3. Find your API key and region under the default project in the left sidebar. +### Milvus Setup + +[Milvus](https://milvus.io/) is a open-source, high scalable vector database to storage huge amount of vector-based memory and provide fast relevant search. + +- setup milvus database, keep your pymilvus version and milvus version same to avoid compatible issues. + - setup by open source [Install Milvus](https://milvus.io/docs/install_standalone-operator.md) + - or setup by [Zilliz Cloud](https://zilliz.com/cloud) +- set `MILVUS_ADDR` in `.env` to your milvus address `host:ip`. +- set `MEMORY_BACKEND` in `.env` to `milvus` to enable milvus as backend. +- optional + - set `MILVUS_COLLECTION` in `.env` to change milvus collection name as you want, `autogpt` is the default name. + ### Setting up environment variables In the `.env` file set: diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 46764b9c0b..667c817820 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -62,6 +62,10 @@ class Config(metaclass=Singleton): self.pinecone_api_key = os.getenv("PINECONE_API_KEY") self.pinecone_region = os.getenv("PINECONE_ENV") + # milvus configuration, e.g., localhost:19530. + self.milvus_addr = os.getenv("MILVUS_ADDR", "localhost:19530") + self.milvus_collection = os.getenv("MILVUS_COLLECTION", "autogpt") + self.image_provider = os.getenv("IMAGE_PROVIDER") self.huggingface_api_token = os.getenv("HUGGINGFACE_API_TOKEN") diff --git a/autogpt/memory/__init__.py b/autogpt/memory/__init__.py index 42ba5a65c9..670efda166 100644 --- a/autogpt/memory/__init__.py +++ b/autogpt/memory/__init__.py @@ -21,6 +21,12 @@ except ImportError: print("Pinecone not installed. Skipping import.") PineconeMemory = None +try: + from memory.milvus import MilvusMemory +except ImportError: + print("pymilvus not installed. Skipping import.") + MilvusMemory = None + def get_memory(cfg, init=False): memory = None @@ -44,6 +50,12 @@ def get_memory(cfg, init=False): memory = RedisMemory(cfg) elif cfg.memory_backend == "no_memory": memory = NoMemory(cfg) + elif cfg.memory_backend == "milvus": + if not MilvusMemory: + print("Error: Milvus sdk is not installed." + "Please install pymilvus to use Milvus as memory backend.") + else: + memory = MilvusMemory(cfg) if memory is None: memory = LocalCache(cfg) @@ -56,4 +68,4 @@ def get_supported_memory_backends(): return supported_memory -__all__ = ["get_memory", "LocalCache", "RedisMemory", "PineconeMemory", "NoMemory"] +__all__ = ["get_memory", "LocalCache", "RedisMemory", "PineconeMemory", "NoMemory", "MilvusMemory"] diff --git a/requirements.txt b/requirements.txt index 44cd600fe2..2fec1b16d1 100644 --- a/requirements.txt +++ b/requirements.txt @@ -12,6 +12,7 @@ docker duckduckgo-search google-api-python-client #(https://developers.google.com/custom-search/v1/overview) pinecone-client==2.2.1 +pymilvus==2.2.4 redis orjson Pillow diff --git a/scripts/memory/milvus.py b/scripts/memory/milvus.py new file mode 100644 index 0000000000..c6d31750c5 --- /dev/null +++ b/scripts/memory/milvus.py @@ -0,0 +1,90 @@ +from pymilvus import ( + connections, + FieldSchema, + CollectionSchema, + DataType, + Collection, +) + +from memory.base import MemoryProviderSingleton, get_ada_embedding + + +class MilvusMemory(MemoryProviderSingleton): + def __init__(self, cfg): + """ Construct a milvus memory storage connection. + + Args: + cfg (Config): Auto-GPT global config. + """ + # connect to milvus server. + connections.connect(address=cfg.milvus_addr) + fields = [ + FieldSchema(name="pk", dtype=DataType.INT64, + is_primary=True, auto_id=True), + FieldSchema(name="embeddings", + dtype=DataType.FLOAT_VECTOR, dim=1536), + FieldSchema(name="raw_text", dtype=DataType.VARCHAR, + max_length=65535) + ] + + # create collection if not exist and load it. + schema = CollectionSchema(fields, "auto-gpt memory storage") + self.collection = Collection(cfg.milvus_collection, schema) + # create index if not exist. + if not self.collection.has_index(index_name="embeddings"): + self.collection.release() + self.collection.create_index("embeddings", { + "index_type": "IVF_FLAT", + "metric_type": "IP", + "params": {"nlist": 128}, + }, index_name="embeddings") + self.collection.load() + + def add(self, data): + """ Add a embedding of data into memory. + + Args: + data (str): The raw text to construct embedding index. + + Returns: + str: log. + """ + embedding = get_ada_embedding(data) + result = self.collection.insert([[embedding], [data]]) + _text = f"Inserting data into memory at primary key: {result.primary_keys[0]}:\n data: {data}" + return _text + + def get(self, data): + """ Return the most relevant data in memory. + Args: + data: The data to compare to. + """ + return self.get_relevant(data, 1) + + def clear(self): + """ Drop the index in memory. + """ + self.collection.drop() + return "Obliviated" + + def get_relevant(self, data, num_relevant=5): + """ Return the top-k relevant data in memory. + Args: + data: The data to compare to. + num_relevant (int, optional): The max number of relevant data. Defaults to 5. + """ + # search the embedding and return the most relevant text. + embedding = get_ada_embedding(data) + search_params = { + "metrics_type": "IP", + "params": {"nprobe": 8}, + } + result = self.collection.search( + [embedding], "embeddings", search_params, num_relevant, output_fields=["raw_text"]) + return [item.entity.value_of_field("raw_text") for item in result[0]] + + def get_stats(self): + """ + Returns: The stats of the milvus cache. + """ + return f"Entities num: {self.collection.num_entities}" From e90e618c5ee9b37ebbc38bd4c75805d3cbceef17 Mon Sep 17 00:00:00 2001 From: Eesa Hamza Date: Sat, 15 Apr 2023 16:28:34 +0300 Subject: [PATCH 17/24] Added agnostic browser support --- .env.template | 3 +++ autogpt/__main__.py | 4 +++- autogpt/args.py | 9 +++++++++ autogpt/commands/web_selenium.py | 28 +++++++++++++++++++++------- autogpt/config/config.py | 1 + 5 files changed, 37 insertions(+), 8 deletions(-) diff --git a/.env.template b/.env.template index 22bf8d74d9..4a334bea91 100644 --- a/.env.template +++ b/.env.template @@ -11,6 +11,9 @@ BROWSE_SUMMARY_MAX_TOKEN=300 # USER_AGENT="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36" # AI_SETTINGS_FILE - Specifies which AI Settings file to use (defaults to ai_settings.yaml) AI_SETTINGS_FILE=ai_settings.yaml +# USE_WEB_BROWSER - Sets the web-browser drivers to use with selenium (defaults to chrome). +# Note: set this to either 'chrome', 'firefox', or 'safari' depending on your current browser +# USE_WEB_BROWSER=chrome ################################################################################ ### LLM PROVIDER diff --git a/autogpt/__main__.py b/autogpt/__main__.py index f90f1532cc..5105df551b 100644 --- a/autogpt/__main__.py +++ b/autogpt/__main__.py @@ -1,5 +1,6 @@ """Main script for the autogpt package.""" import logging +from colorama import Fore from autogpt.agent.agent import Agent from autogpt.args import parse_arguments @@ -33,7 +34,8 @@ def main() -> None: # Initialize memory and make sure it is empty. # this is particularly important for indexing and referencing pinecone memory memory = get_memory(cfg, init=True) - print(f"Using memory of type: {memory.__class__.__name__}") + logger.typewriter_log(f"Using memory of type:", Fore.GREEN, f"{memory.__class__.__name__}") + logger.typewriter_log(f"Using Browser:", Fore.GREEN, cfg.selenium_web_browser) agent = Agent( ai_name=ai_name, memory=memory, diff --git a/autogpt/args.py b/autogpt/args.py index 6c907a1f6a..0bc3e6809b 100644 --- a/autogpt/args.py +++ b/autogpt/args.py @@ -50,6 +50,12 @@ def parse_arguments() -> None: action="store_true", help="Skips the re-prompting messages at the beginning of the script", ) + parser.add_argument( + "--use-browser", + "-b", + dest="browser_name", + help="Specifies which web-browser to use when using selenium to scrape the web." + ) parser.add_argument( "--ai-settings", "-C", @@ -126,3 +132,6 @@ def parse_arguments() -> None: logger.typewriter_log("Using AI Settings File:", Fore.GREEN, file) CFG.ai_settings_file = file CFG.skip_reprompt = True + + if args.browser_name: + CFG.selenium_web_browser = args.browser_name diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py index 4d5703aa88..379d8cbee3 100644 --- a/autogpt/commands/web_selenium.py +++ b/autogpt/commands/web_selenium.py @@ -7,7 +7,10 @@ from selenium.webdriver.common.by import By from selenium.webdriver.support.wait import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from webdriver_manager.chrome import ChromeDriverManager -from selenium.webdriver.chrome.options import Options +from webdriver_manager.firefox import GeckoDriverManager +from selenium.webdriver.chrome.options import Options as ChromeOptions +from selenium.webdriver.firefox.options import Options as FirefoxOptions +from selenium.webdriver.safari.options import Options as SafariOptions import logging from pathlib import Path from autogpt.config import Config @@ -49,14 +52,25 @@ def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: """ logging.getLogger("selenium").setLevel(logging.CRITICAL) - options = Options() + options_available = {'chrome': ChromeOptions, 'safari': SafariOptions, 'firefox': FirefoxOptions} + + options = options_available[CFG.selenium_web_browser]() options.add_argument( - "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" - " (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" - ) - driver = webdriver.Chrome( - executable_path=ChromeDriverManager().install(), options=options + "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" ) + + if CFG.selenium_web_browser == "firefox": + driver = webdriver.Firefox( + executable_path=GeckoDriverManager().install(), options=options + ) + elif CFG.selenium_web_browser == "safari": + # Requires a bit more setup on the users end + # See https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari + driver = webdriver.Safari(options=options) + else: + driver = webdriver.Chrome( + executable_path=ChromeDriverManager().install(), options=options + ) driver.get(url) WebDriverWait(driver, 10).until( diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 46764b9c0b..87e53304ed 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -25,6 +25,7 @@ class Config(metaclass=Singleton): self.speak_mode = False self.skip_reprompt = False + self.selenium_web_browser = os.getenv("USE_WEB_BROWSER", "chrome") self.ai_settings_file = os.getenv("AI_SETTINGS_FILE", "ai_settings.yaml") self.fast_llm_model = os.getenv("FAST_LLM_MODEL", "gpt-3.5-turbo") self.smart_llm_model = os.getenv("SMART_LLM_MODEL", "gpt-4") From 55facfd8db41342a9879321204480ecd4b6cf950 Mon Sep 17 00:00:00 2001 From: Bufo Date: Sat, 15 Apr 2023 15:59:14 +0200 Subject: [PATCH 18/24] remove sourcery from docker build --- Dockerfile | 6 +++--- requirements-docker.txt | 25 +++++++++++++++++++++++++ 2 files changed, 28 insertions(+), 3 deletions(-) create mode 100644 requirements-docker.txt diff --git a/Dockerfile b/Dockerfile index 3ae1ac1219..d62751fa44 100644 --- a/Dockerfile +++ b/Dockerfile @@ -13,11 +13,11 @@ RUN chown appuser:appuser /home/appuser USER appuser # Copy the requirements.txt file and install the requirements -COPY --chown=appuser:appuser requirements.txt . -RUN pip install --no-cache-dir --user -r requirements.txt +COPY --chown=appuser:appuser requirements-docker.txt . +RUN pip install --no-cache-dir --user -r requirements-docker.txt # Copy the application files -COPY --chown=appuser:appuser autogpt/ . +COPY --chown=appuser:appuser autogpt/ ./autogpt # Set the entrypoint ENTRYPOINT ["python", "-m", "autogpt"] diff --git a/requirements-docker.txt b/requirements-docker.txt new file mode 100644 index 0000000000..fecbd0a6da --- /dev/null +++ b/requirements-docker.txt @@ -0,0 +1,25 @@ +beautifulsoup4 +colorama==0.4.6 +openai==0.27.2 +playsound==1.2.2 +python-dotenv==1.0.0 +pyyaml==6.0 +readability-lxml==0.8.1 +requests +tiktoken==0.3.3 +gTTS==2.3.1 +docker +duckduckgo-search +google-api-python-client #(https://developers.google.com/custom-search/v1/overview) +pinecone-client==2.2.1 +redis +orjson +Pillow +selenium +webdriver-manager +coverage +flake8 +numpy +pre-commit +black +isort From afd2c5e2c6c33685e2e1ba815cf2ee46e278301f Mon Sep 17 00:00:00 2001 From: youkaichao Date: Sat, 15 Apr 2023 22:04:05 +0800 Subject: [PATCH 19/24] update type annotation --- autogpt/agent/agent_manager.py | 2 +- autogpt/commands/web_requests.py | 2 +- autogpt/commands/web_selenium.py | 23 ++++++++++++----------- 3 files changed, 14 insertions(+), 13 deletions(-) diff --git a/autogpt/agent/agent_manager.py b/autogpt/agent/agent_manager.py index a22adff38f..3467f8bf33 100644 --- a/autogpt/agent/agent_manager.py +++ b/autogpt/agent/agent_manager.py @@ -14,7 +14,7 @@ class AgentManager(metaclass=Singleton): # Create new GPT agent # TODO: Centralise use of create_chat_completion() to globally enforce token limit - def create_agent(self, task: str, prompt: str, model: str) -> tuple[int, str]: + def create_agent(self, task: str, prompt: str, model: str) -> Tuple[int, str]: """Create a new agent and return its key Args: diff --git a/autogpt/commands/web_requests.py b/autogpt/commands/web_requests.py index 59c3e5229f..97b23fe4e2 100644 --- a/autogpt/commands/web_requests.py +++ b/autogpt/commands/web_requests.py @@ -72,7 +72,7 @@ def get_response( timeout (int): The timeout for the HTTP request Returns: - tuple[None, str] | tuple[Response, None]: The response and error message + Tuple[None, str] | Tuple[Response, None]: The response and error message Raises: ValueError: If the URL is invalid diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py index 4d5703aa88..727695ef2f 100644 --- a/autogpt/commands/web_selenium.py +++ b/autogpt/commands/web_selenium.py @@ -11,12 +11,13 @@ from selenium.webdriver.chrome.options import Options import logging from pathlib import Path from autogpt.config import Config +from typing import List, Tuple, Union FILE_DIR = Path(__file__).parent.parent CFG = Config() -def browse_website(url: str, question: str) -> tuple[str, WebDriver]: +def browse_website(url: str, question: str) -> Tuple[str, WebDriver]: """Browse a website and return the answer and links to the user Args: @@ -24,7 +25,7 @@ def browse_website(url: str, question: str) -> tuple[str, WebDriver]: question (str): The question asked by the user Returns: - tuple[str, WebDriver]: The answer and links to the user and the webdriver + Tuple[str, WebDriver]: The answer and links to the user and the webdriver """ driver, text = scrape_text_with_selenium(url) add_header(driver) @@ -38,14 +39,14 @@ def browse_website(url: str, question: str) -> tuple[str, WebDriver]: return f"Answer gathered from website: {summary_text} \n \n Links: {links}", driver -def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: +def scrape_text_with_selenium(url: str) -> Tuple[WebDriver, str]: """Scrape text from a website using selenium Args: url (str): The url of the website to scrape Returns: - tuple[WebDriver, str]: The webdriver and the text scraped from the website + Tuple[WebDriver, str]: The webdriver and the text scraped from the website """ logging.getLogger("selenium").setLevel(logging.CRITICAL) @@ -77,14 +78,14 @@ def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: return driver, text -def scrape_links_with_selenium(driver: WebDriver) -> list[str]: +def scrape_links_with_selenium(driver: WebDriver) -> List[str]: """Scrape links from a website using selenium Args: driver (WebDriver): The webdriver to use to scrape the links Returns: - list[str]: The links scraped from the website + List[str]: The links scraped from the website """ page_source = driver.page_source soup = BeautifulSoup(page_source, "html.parser") @@ -109,26 +110,26 @@ def close_browser(driver: WebDriver) -> None: driver.quit() -def extract_hyperlinks(soup: BeautifulSoup) -> list[tuple[str, str]]: +def extract_hyperlinks(soup: BeautifulSoup) -> List[Tuple[str, str]]: """Extract hyperlinks from a BeautifulSoup object Args: soup (BeautifulSoup): The BeautifulSoup object to extract the hyperlinks from Returns: - list[tuple[str, str]]: The hyperlinks extracted from the BeautifulSoup object + List[Tuple[str, str]]: The hyperlinks extracted from the BeautifulSoup object """ return [(link.text, link["href"]) for link in soup.find_all("a", href=True)] -def format_hyperlinks(hyperlinks: list[tuple[str, str]]) -> list[str]: +def format_hyperlinks(hyperlinks: List[Tuple[str, str]]) -> List[str]: """Format hyperlinks to be displayed to the user Args: - hyperlinks (list[tuple[str, str]]): The hyperlinks to format + hyperlinks (List[Tuple[str, str]]): The hyperlinks to format Returns: - list[str]: The formatted hyperlinks + List[str]: The formatted hyperlinks """ return [f"{link_text} ({link_url})" for link_text, link_url in hyperlinks] From a51b37f01c68fc00308ab01a47e6c93e34906fb3 Mon Sep 17 00:00:00 2001 From: youkaichao Date: Sat, 15 Apr 2023 22:10:22 +0800 Subject: [PATCH 20/24] fix dict type annotation --- autogpt/llm_utils.py | 2 +- autogpt/processing/text.py | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index f2418b658f..260403e243 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -59,7 +59,7 @@ def create_chat_completion( """Create a chat completion using the OpenAI API Args: - messages (list[dict[str, str]]): The messages to send to the chat completion + messages (List[Dict[str, str]]): The messages to send to the chat completion model (str, optional): The model to use. Defaults to None. temperature (float, optional): The temperature to use. Defaults to 0.9. max_tokens (int, optional): The max tokens to use. Defaults to None. diff --git a/autogpt/processing/text.py b/autogpt/processing/text.py index 24e3bb8581..d9e335f821 100644 --- a/autogpt/processing/text.py +++ b/autogpt/processing/text.py @@ -1,5 +1,5 @@ """Text processing functions""" -from typing import Generator, Optional +from typing import Generator, Optional, Dict from selenium.webdriver.remote.webdriver import WebDriver from autogpt.memory import get_memory from autogpt.config import Config @@ -114,7 +114,7 @@ def scroll_to_percentage(driver: WebDriver, ratio: float) -> None: driver.execute_script(f"window.scrollTo(0, document.body.scrollHeight * {ratio});") -def create_message(chunk: str, question: str) -> dict[str, str]: +def create_message(chunk: str, question: str) -> Dict[str, str]: """Create a message for the chat completion Args: @@ -122,7 +122,7 @@ def create_message(chunk: str, question: str) -> dict[str, str]: question (str): The question to answer Returns: - dict[str, str]: The message to send to the chat completion + Dict[str, str]: The message to send to the chat completion """ return { "role": "user", From 44bd3d67179f26ce065ca2e3f292018c230e4d30 Mon Sep 17 00:00:00 2001 From: Thibault Twahirwa Date: Sat, 15 Apr 2023 10:17:03 -0400 Subject: [PATCH 21/24] Fixed the import --- autogpt/json_fixes/auto_fix.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/autogpt/json_fixes/auto_fix.py b/autogpt/json_fixes/auto_fix.py index 60c089a2fb..9c632332c5 100644 --- a/autogpt/json_fixes/auto_fix.py +++ b/autogpt/json_fixes/auto_fix.py @@ -2,6 +2,8 @@ import json from autogpt.llm_utils import call_ai_function from autogpt.logs import logger +from autogpt.config import Config +cfg = Config() def fix_json(json_str: str, schema: str) -> str: From f9265e9b010378a33e4901ef2dd9fac4f345496a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20St=C3=BCbi?= Date: Sat, 15 Apr 2023 16:20:26 +0200 Subject: [PATCH 22/24] Some more file extensions to ignore --- .gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitignore b/.gitignore index cf6e75df15..3538e9fdf3 100644 --- a/.gitignore +++ b/.gitignore @@ -16,6 +16,8 @@ last_run_ai_settings.yaml .idea/* auto-gpt.json log.txt +*.log +*.mp3 # Coverage reports .coverage From a0de3868c6c77bf4d8605bbdbaf759037c04174e Mon Sep 17 00:00:00 2001 From: Summit Suen Date: Fri, 14 Apr 2023 15:33:43 +0800 Subject: [PATCH 23/24] Cleanup azure parameters in env.template and remove unused env in config.load_azure_config(). --- .env.template | 11 +---------- autogpt/config/config.py | 12 +++--------- 2 files changed, 4 insertions(+), 19 deletions(-) diff --git a/.env.template b/.env.template index 22bf8d74d9..53fe42abad 100644 --- a/.env.template +++ b/.env.template @@ -25,16 +25,7 @@ TEMPERATURE=1 USE_AZURE=False ### AZURE -# OPENAI_AZURE_API_BASE - OpenAI API base URL for Azure (Example: https://my-azure-openai-url.com) -# OPENAI_AZURE_API_VERSION - OpenAI API version for Azure (Example: v1) -# OPENAI_AZURE_DEPLOYMENT_ID - OpenAI deployment ID for Azure (Example: my-deployment-id) -# OPENAI_AZURE_CHAT_DEPLOYMENT_ID - OpenAI deployment ID for Azure Chat (Example: my-deployment-id-for-azure-chat) -# OPENAI_AZURE_EMBEDDINGS_DEPLOYMENT_ID - OpenAI deployment ID for Embedding (Example: my-deployment-id-for-azure-embeddigs) -OPENAI_AZURE_API_BASE=your-base-url-for-azure -OPENAI_AZURE_API_VERSION=api-version-for-azure -OPENAI_AZURE_DEPLOYMENT_ID=deployment-id-for-azure -OPENAI_AZURE_CHAT_DEPLOYMENT_ID=deployment-id-for-azure-chat -OPENAI_AZURE_EMBEDDINGS_DEPLOYMENT_ID=deployment-id-for-azure-embeddigs +# cleanup azure env as already moved to `azure.yaml.template` ################################################################################ ### LLM MODELS diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 46764b9c0b..a51f4d2053 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -127,15 +127,9 @@ class Config(metaclass=Singleton): config_params = yaml.load(file, Loader=yaml.FullLoader) except FileNotFoundError: config_params = {} - self.openai_api_type = os.getenv( - "OPENAI_API_TYPE", config_params.get("azure_api_type", "azure") - ) - self.openai_api_base = os.getenv( - "OPENAI_AZURE_API_BASE", config_params.get("azure_api_base", "") - ) - self.openai_api_version = os.getenv( - "OPENAI_AZURE_API_VERSION", config_params.get("azure_api_version", "") - ) + self.openai_api_type = config_params.get("azure_api_type") or "azure" + self.openai_api_base = config_params.get("azure_api_base") or "" + self.openai_api_version = config_params.get("azure_api_version") or "2023-03-15-preview" self.azure_model_to_deployment_id_map = config_params.get("azure_model_map", []) def set_continuous_mode(self, value: bool) -> None: From 02db53e12fe167042f2318af28d7d2f7e2bca228 Mon Sep 17 00:00:00 2001 From: Jedakiah Date: Sat, 15 Apr 2023 17:01:29 +0200 Subject: [PATCH 24/24] Fixed error when google search contains funny characters --- autogpt/app.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/autogpt/app.py b/autogpt/app.py index 0adfde5d5b..8d9cc9eeab 100644 --- a/autogpt/app.py +++ b/autogpt/app.py @@ -105,9 +105,11 @@ def execute_command(command_name: str, arguments): # search method key = CFG.google_api_key if key and key.strip() and key != "your-google-api-key": - return google_official_search(arguments["input"]) + google_result = google_official_search(arguments["input"]) else: - return google_search(arguments["input"]) + google_result = google_search(arguments["input"]) + safe_message = google_result.encode('utf-8', 'ignore') + return str(safe_message) elif command_name == "memory_add": return memory.add(arguments["string"]) elif command_name == "start_agent":