camel package

camel package#

Subpackages#

Submodules#

camel.generators module#

class camel.generators.AISocietyTaskPromptGenerator(num_tasks: int = 10)[source]#

Bases: object

Task prompt generator for AI society tasks.

Parameters:

num_tasks (int, optional) – The number of tasks to generate. (default: 10)

from_role_files(assistant_role_names_path: str = 'data/ai_society/assistant_roles.txt', user_role_names_path: str = 'data/ai_society/user_roles.txt') → Generator[Tuple[str, Tuple[str, str]], None, None][source]#

Generate tasks from role files.

Parameters:

  • assistant_role_names_path (str, optional) – The path to the file containing the assistant role names. (default: "data/ai_society/assistant_roles.txt")

  • user_role_names_path (str, optional) – The path to the file containing the user role names. (default: "data/ai_society/user_roles.txt")

Returns:

A generator

that yields tuples of task prompts and role names.

Return type:

Generator[Tuple[str, Tuple[str, str]], None, None]

from_role_generator(role_generator: Generator[Tuple, None, None]) → Generator[Tuple[str, Tuple[str, str]], None, None][source]#

Generate tasks from a role generator.

Parameters:

role_generator (Generator[Tuple, None, None]) – A generator that yields tuples of role names.

Returns:

A generator

that yields tuples of task prompts and role names.

Return type:

Generator[Tuple[str, Tuple[str, str]], None, None]

class camel.generators.CodeTaskPromptGenerator(num_tasks: int = 50)[source]#

Bases: object

Code task prompt generator for code tasks.

Parameters:

num_tasks (int, optional) – The number of tasks to generate. (default: 50)

from_role_files(languages_path: str = 'data/code/languages.txt', domains_path: str = 'data/code/domains.txt') → Generator[Tuple[TextPrompt, str, str], None, None][source]#

Generate tasks from role files.

Parameters:

  • languages_path (str, optional) – The path to the file containing the language names. (default: "data/code/languages.txt")

  • domains_path (str, optional) – The path to the file containing the domain names. (default: "data/code/domains.txt")

Returns:

A generator

that yields tuples of task prompts, language names, and domain names.

Return type:

Generator[Tuple[TextPrompt, str, str], None, None]

from_role_generator(role_generator: Generator[Tuple, None, None]) → Generator[str, None, None][source]#

Generate tasks from a role generator.

Parameters:

role_generator (Generator[Tuple, None, None]) – A generator that yields tuples of role names.

Returns:

A generator that yields the task

prompts.

Return type:

Generator[str, None, None]

class camel.generators.RoleNameGenerator(assistant_role_names_path: str = 'data/ai_society/assistant_roles.txt', user_role_names_path: str = 'data/ai_society/user_roles.txt', assistant_role_names: List[str] | None = None, user_role_names: List[str] | None = None)[source]#

Bases: object

Role name generator for role-playing workers.

Parameters:

  • assistant_role_names_path (str, optional) – The path to the file containing the assistant role names. (default: "data/ai_society/assistant_roles.txt")

  • user_role_names_path (str, optional) – The path to the file containing the user role names. (default: "data/ai_society/user_roles.txt")

  • assistant_role_names (Optional[List[str]], optional) – The list of assistant role names. (default: None)

  • user_role_names (Optional[List[str]], optional) – The list of user role names. (default: None)

from_role_files() → Generator[Tuple, None, None][source]#

Generate role names from the file.

Returns:

A generator that yields tuples of

assistant role names and user role names.

Return type:

Generator[Tuple, None, None]

class camel.generators.SingleTxtGenerator(text_file_path: str)[source]#

Bases: object

Single text generator for role-playing workers.

Parameters:

text_file_path (str) – The path to the file containing the text data.

from_role_files() → Generator[str, None, None][source]#

Generate text from the file.

Returns:

A generator that yields the text data.

Return type:

Generator[str, None, None]

class camel.generators.SystemMessageGenerator(task_type: TaskType = TaskType.AI_SOCIETY, sys_prompts: Dict[RoleType, str] | None = None, sys_msg_meta_dict_keys: Set[str] | None = None)[source]#

Bases: object

System message generator for agents.

Parameters:

  • task_type (TaskType, optional) – The task type. (default: TaskType.AI_SOCIETY)

  • sys_prompts (Optional[Dict[RoleType, str]], optional) – The prompts of the system messages for each role type. (default: None)

  • sys_msg_meta_dict_keys (Optional[Set[str]], optional) – The set of keys of the meta dictionary used to fill the prompts. (default: None)

from_dict(meta_dict: Dict[str, str], role_tuple: Tuple[str, RoleType] = ('', RoleType.DEFAULT)) → BaseMessage[source]#

Generates a system message from a dictionary.

Parameters:

  • meta_dict (Dict[str, str]) – The dictionary containing the information to generate the system message.

  • role_tuple (Tuple[str, RoleType], optional) – The tuple containing the role name and role type. (default: (“”, RoleType.DEFAULT))

Returns:

The generated system message.

Return type:

BaseMessage

from_dicts(meta_dicts: List[Dict[str, str]], role_tuples: List[Tuple[str, RoleType]]) → List[BaseMessage][source]#

Generates a list of system messages from a list of dictionaries.

Parameters:

  • meta_dicts (List[Dict[str, str]]) – A list of dictionaries containing the information to generate the system messages.

  • role_tuples (List[Tuple[str, RoleType]]) – A list of tuples containing the role name and role type for each system message.

Returns:

A list of generated system messages.

Return type:

List[BaseMessage]

Raises:

ValueError – If the number of meta_dicts and role_tuples are different.

validate_meta_dict_keys(meta_dict: Dict[str, str]) → None[source]#

Validates the keys of the meta_dict.

Parameters:

meta_dict (Dict[str, str]) – The dictionary to validate.

camel.human module#

class camel.human.Human(name: str = 'Kill Switch Engineer', logger_color: Any = '\x1b[35m')[source]#

Bases: object

A class representing a human user.

Parameters:

  • name (str) – The name of the human user. (default: "Kill Switch Engineer").

  • logger_color (Any) – The color of the menu options displayed to the user. (default: Fore.MAGENTA)

name#

The name of the human user.

Type:

str

logger_color#

The color of the menu options displayed to the user.

Type:

Any

input_button#

The text displayed for the input button.

Type:

str

kill_button#

The text displayed for the kill button.

Type:

str

options_dict#

A dictionary containing the options displayed to the user.

Type:

Dict[str, str]

display_options(messages: Sequence[BaseMessage]) → None[source]#

Displays the options to the user.

Parameters:

messages (Sequence[BaseMessage]) – A list of BaseMessage objects.

Returns:

None

get_input() → str[source]#

Gets the input from the user.

Returns:

The user’s input.

Return type:

str

parse_input(human_input: str) → str[source]#

Parses the user’s input and returns a BaseMessage object.

Parameters:

human_input (str) – The user’s input.

Returns:

A str object representing the user’s input.

Return type:

content

reduce_step(messages: Sequence[BaseMessage]) → ChatAgentResponse[source]#

Performs one step of the conversation by displaying options to the user, getting their input, and parsing their choice.

Parameters:

messages (Sequence[BaseMessage]) – A list of BaseMessage objects.

Returns:

A ChatAgentResponse object representing the

user’s choice.

Return type:

ChatAgentResponse

Module contents#

camel.disable_logging()[source]#

Disable all logging for the CAMEL library.

This function sets the log level to a value higher than CRITICAL, effectively disabling all log messages, and adds a NullHandler to suppress any potential warnings about no handlers being found.

camel.enable_logging()[source]#

Enable logging for the CAMEL library.

This function re-enables logging if it was previously disabled, and configures the library logging using the default settings. If the logging is already configured,

this function does not change its configuration.

camel.set_log_level(level)[source]#

Set the logging level for the CAMEL library.

Parameters:

level (Union[str, int]) – The logging level to set. This can be a string (e.g., ‘INFO’) or a logging level constant (e.g., logging.INFO, logging.DEBUG). See https://docs.python.org/3/library/logging.html#levels

Raises:

ValueError – If the provided level is not a valid logging level.