{"id":15026820,"url":"https://github.com/llm-agents-php/sample-app-laravel","last_synced_at":"2025-04-09T20:21:42.083Z","repository":{"id":255558825,"uuid":"849736999","full_name":"llm-agents-php/sample-app-laravel","owner":"llm-agents-php","description":"This sample application demonstrates the practical implementation and usage patterns of the LLM Agents library.","archived":false,"fork":false,"pushed_at":"2024-09-15T12:51:16.000Z","size":122,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T22:13:33.341Z","etag":null,"topics":["laravel","llm-agent","llm-agents","llm-tool-call","llm-tools","openai","openai-tools","php","php8"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/llm-agents-php.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-30T06:34:32.000Z","updated_at":"2025-03-17T11:18:08.000Z","dependencies_parsed_at":"2024-09-15T14:32:12.194Z","dependency_job_id":null,"html_url":"https://github.com/llm-agents-php/sample-app-laravel","commit_stats":null,"previous_names":["llm-agents-php/sample-app-laravel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/llm-agents-php%2Fsample-app-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/llm-agents-php%2Fsample-app-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/llm-agents-php%2Fsample-app-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/llm-agents-php%2Fsample-app-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/llm-agents-php","download_url":"https://codeload.github.com/llm-agents-php/sample-app-laravel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248104449,"owners_count":21048340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","llm-agent","llm-agents","llm-tool-call","llm-tools","openai","openai-tools","php","php8"],"created_at":"2024-09-24T20:05:12.016Z","updated_at":"2025-04-09T20:21:42.046Z","avatar_url":"https://github.com/llm-agents-php.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LLM Agents Sample App - Laravel edition\n\nThis sample application demonstrates the practical implementation and usage patterns of the LLM Agents library.\n\n\u003e For more information about the LLM Agents package and its capabilities, please refer to\n\u003e the [LLM Agents documentation](https://github.com/llm-agents-php/agents).\n\nIt provides a CLI interface to interact with various AI agents, showcasing the power and flexibility of the LLM Agents\npackage.\n\n![image](https://github.com/user-attachments/assets/53104067-d3df-4983-8a59-435708f2b70c)\n\n## Features\n\n- Multiple pre-configured AI agents with different capabilities\n- CLI interface for easy interaction with agents\n- Integration with OpenAI's GPT models\n- Database support for session persistence\n\n## Prerequisites\n\n- PHP 8.3 or higher\n- Composer\n- Git\n- OpenAI API key\n\n## Quick Start with Docker\n\nThe easiest way to run the app is using our pre-built Docker image.\n\n**Follow these steps to get started:**\n\n1. Make sure you have Docker installed on your system.\n\n2. Create a `.env` file in the project root directory:\n\n```bash\ncp .env.example .env\n```\n\nand add your OpenAI API key to the `.env` file:\n\n```bash\nOPENAI_API_KEY=your_api_key_here\n```\n\n\u003e Replace `\u003cyour_api_key\u003e` with your OpenAI API key.\n\n3. Run the Docker container with the following command:\n\n```bash\nmake up\n```\n\n4Once the container is running, you can interact with the app using the following command:\n\n## Usage\n\n### Chatting with Agents\n\nTo start a chat session with an AI agent:\n\n1. Run the following command:\n\n**Using docker container**\n\n```bash\nmake chat\n```\n\n2. You will see a list of available agents and their descriptions. Choose the desired agent by entering its number.\n\n![image](https://github.com/user-attachments/assets/3cd223a8-3ab0-4879-9e85-83539c93003f)\n\n3. After selecting an agent, you will see a message like this:\n\n![image](https://github.com/user-attachments/assets/0d18ca6c-9ee9-4942-b383-fc42abf18bc7)\n\n```bash\n************************************************************\n*     Run the following command to see the AI response     *\n************************************************************\n\nphp artisan chat:session \u003csession_uuid\u003e -v\n```\n\n**Using docker container**\n\n```bash\nmake bash\n```\n\nThen run the following command:\n\n```bash\nphp artisan chat:session \u003csession_uuid\u003e -v\n```\n\n\u003e Replace `\u003csession_uuid\u003e` with the actual session UUID.\n\n5. Copy the provided command and run it in a new terminal tab. This command will show the AI response to your message.\n\n![image](https://github.com/user-attachments/assets/1dfdfdd1-f69d-44af-afb2-807f9fa2da84)\n\n## Available CLI Commands\n\nThe sample app provides several CLI commands for interacting with agents and managing the application:\n\n- `php artisan agent:list`: List all available agents\n- `php artisan tool:list`: List all available tools\n- `php artisan chat`: Start a new chat session\n- `php artisan chat:session \u003csession-id\u003e`: Continue an existing chat session\n\nUse the `-h` or `--help` option with any command to see more details about its usage.\n\n## Available Agents\n\nThe sample app comes with several pre-configured agents, each designed for specific tasks:\n\n### Site Status Checker\n\n- **Key**: `site_status_checker`\n- **Description**: This agent specializes in checking the online status of websites. It can verify if a given URL is\n  accessible, retrieve basic information about the site, and provide insights on potential issues if a site is\n  offline.\n- **Capabilities**:\n    - Check site availability\n    - Retrieve DNS information\n    - Perform ping tests\n    - Provide troubleshooting steps for offline sites\n\n### Order Assistant\n\n- **Key**: `order_assistant`\n- **Description**: This agent helps customers with order-related questions. It can retrieve order information, check\n  delivery status, and provide customer support for e-commerce related queries.\n- **Capabilities**:\n    - Retrieve order numbers\n    - Check delivery dates\n    - Access customer profiles\n    - Provide personalized assistance based on customer age and preferences\n\n### Smart Home Control Assistant\n\n- **Key**: `smart_home_control`\n- **Description**: This agent manages and controls various smart home devices across multiple rooms, including\n  lights, thermostats, and TVs.\n- **Capabilities**:\n    - List devices in specific rooms\n    - Control individual devices (turn on/off, adjust settings)\n    - Retrieve device status and details\n    - Suggest energy-efficient settings\n\n### Code Review Agent\n\n- **Key**: `code_review`\n- **Description**: This agent specializes in reviewing code. It can analyze code files, provide feedback, and\n  suggest improvements.\n- **Capabilities**:\n    - List files in a project\n    - Read file contents\n    - Perform code reviews\n    - Submit review comments\n\n### Task Splitter\n\n- **Key**: `task_splitter`\n- **Description**: This agent analyzes project descriptions and breaks them down into structured task lists with\n  subtasks.\n- **Capabilities**:\n    - Retrieve project descriptions\n    - Create hierarchical task structures\n    - Assign task priorities\n    - Generate detailed subtasks\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis sample app is open-source software licensed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllm-agents-php%2Fsample-app-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fllm-agents-php%2Fsample-app-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllm-agents-php%2Fsample-app-laravel/lists"}