{"id":31328103,"url":"https://github.com/pilottai/pilottai","last_synced_at":"2025-09-25T23:56:37.683Z","repository":{"id":273255427,"uuid":"919124712","full_name":"pilottai/pilottai","owner":"pilottai","description":"Python framework for building scalable multi-agent systems with built-in orchestration, LLM integration, and intelligent task processing. Features dynamic scaling, fault tolerance, and advanced load balancing.","archived":false,"fork":false,"pushed_at":"2025-08-19T14:43:58.000Z","size":3561,"stargazers_count":235,"open_issues_count":10,"forks_count":15,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-09-15T14:30:47.354Z","etag":null,"topics":["agent-framework","agents","ai","generative-ai","llm","multi-agent-systems","opensource","pilottai","pydantic","python"],"latest_commit_sha":null,"homepage":"https://pilottai.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pilottai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-19T19:05:40.000Z","updated_at":"2025-09-08T10:07:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"f8b832d0-7a00-45b2-aef1-79b19dce9475","html_url":"https://github.com/pilottai/pilottai","commit_stats":null,"previous_names":["anuj0456/pilottai","pygig/pilottai","pilottai/pilottai"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/pilottai/pilottai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilottai%2Fpilottai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilottai%2Fpilottai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilottai%2Fpilottai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilottai%2Fpilottai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pilottai","download_url":"https://codeload.github.com/pilottai/pilottai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilottai%2Fpilottai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276999963,"owners_count":25742818,"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","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["agent-framework","agents","ai","generative-ai","llm","multi-agent-systems","opensource","pilottai","pydantic","python"],"created_at":"2025-09-25T23:56:32.169Z","updated_at":"2025-09-25T23:56:33.009Z","avatar_url":"https://github.com/pilottai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\" style=\"margin-bottom: -100px;\"\u003ePilottAI\u003c/h1\u003e\n\n\u003cdiv align=\"center\" style=\"margin-top: 20px;\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/pygig/pilottai/main/docs/assets/logo.svg\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/pygig/pilottai/main/docs/assets/logo.svg\"\u003e\n    \u003cimg alt=\"PilottAI Framework Logo\" src=\"https://raw.githubusercontent.com/pygig/pilottai/main/docs/assets/logo.svg\" width=\"500\"\u003e\n  \u003c/picture\u003e\n  \u003ch3\u003eBuild Intelligent Multi-Agent Systems with Python\u003c/h3\u003e\n  \u003cp\u003e\u003cem\u003eScale your AI applications with orchestrated autonomous agents\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n[![PyPI version](https://badge.fury.io/py/pilottai.svg)](https://badge.fury.io/py/pilottai)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Documentation Status](https://github.com/pilottai/pilottai/actions/workflows/deploy-docs.yml/badge.svg?branch=main)](https://docs.pilottai.com)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Commit Activity](https://img.shields.io/github/commit-activity/m/pygig/pilottai?style=flat-square)](https://github.com/pygig/pilottai)\n\n## Overview\n\nPilottAI is a Python framework for building autonomous multi-agent systems with advanced orchestration capabilities. It provides enterprise-ready features for building scalable AI applications.\n\n### Key Features\n\n- 🤖 **Hierarchical Agent System**\n  - Manager and worker agent hierarchies\n  - Intelligent job routing\n  - Context-aware processing\n  - Specialized agent implementations\n\n- 🚀 **Production Ready**\n  - Asynchronous processing\n  - Dynamic scaling\n  - Load balancing\n  - Fault tolerance\n  - Comprehensive logging\n\n- 🧠 **Advanced Memory**\n  - Semantic storage\n  - Job history tracking\n  - Context preservation\n  - Knowledge retrieval\n\n- 🔌 **Integrations**\n  - Multiple LLM providers (OpenAI, Anthropic, Google)\n  - Document processing\n  - WebSocket support\n  - Custom tool integration\n\n## Installation\n\n```bash\npip install pilottai\n```\n\n## Quick Start\n\n```python\nfrom pilottai import Pilott\nfrom pilottai.core import AgentConfig, AgentType, LLMConfig\n\n# Configure LLM\nllm_config = LLMConfig(\n  model_name=\"gpt-4\",\n  provider=\"openai\",\n  api_key=\"your-api-key\"\n)\n\n# Setup agent configuration\nconfig = AgentConfig(\n  title=\"processor\",\n  agent_type=AgentType.WORKER,\n  goal=\"Process documents efficiently\",\n  description=\"Document processing worker\",\n  max_queue_size=100\n)\n\n\nasync def main():\n  # Initialize system\n  pilott = Pilott(name=\"DocumentProcessor\")\n\n  try:\n    # Start system\n    await pilott.start()\n\n    # Add agent\n    agent = await pilott.add_agent(\n      agent_type=\"processor\",\n      config=config,\n      llm_config=llm_config\n    )\n\n    # Process document\n    result = await pilott.execute_job({\n      \"type\": \"process_document\",\n      \"file_path\": \"document.pdf\"\n    })\n\n    print(f\"Processing result: {result}\")\n\n  finally:\n    await pilott.stop()\n\n\nif __name__ == \"__main__\":\n  import asyncio\n\n  asyncio.run(main())\n```\n\n## Specialized Agents\n\nPilottAI includes ready-to-use specialized agents:\n\n- 🎫 [Customer Service Agent](pilottai/examples/customer_service.py): Ticket and support management\n- 📄 [Document Processing Agent](pilottai/examples/document_processing.py): Document analysis and extraction\n- 📧 [Email Agent](pilottai/examples/email_service.py): Email handling and template management\n- 🧠 [Learning Agent](pilottai/examples/teacher.py): Knowledge acquisition and pattern recognition\n- 📢 [Marketing Expert Agent](pilottai/examples/marketing_expert.py): Campaign management and content creation\n- 📊 [Research Analyst Agent](pilottai/examples/research_analyst.py): Data analysis and research synthesis\n- 💼 [Sales Representative Agent](pilottai/examples/sales_rep.py): Lead management and proposals\n- 🌐 [Social Media Agent](pilottai/examples/social_media_manager.py): Content scheduling and engagement\n- 🔍 [Web Search Agent](pilottai/examples/web_search.py): Search operations and analysis\n\n## 📚 Documentation\n\n👉 **[Read the full documentation here](https://docs.pilottai.com)**\n\nThe documentation includes:\n- Detailed guides\n- API reference\n- Examples\n- Best practices\n\n## Example Use Cases\n\n- 📄 **Document Processing**\n  ```python\n  # Process PDF documents\n  result = await pilott.execute_job({\n      \"type\": \"process_pdf\",\n      \"file_path\": \"document.pdf\"\n  })\n  ```\n\n- 🤖 **AI Agents**\n  ```python\n  # Create specialized agents\n  researcher = await pilott.add_agent(\n      agent_type=\"researcher\",\n      config=researcher_config\n  )\n  ```\n\n- 🔄 **Job Orchestration**\n  ```python\n  # Orchestrate complex workflows\n  job_result = await manager_agent.execute_job({\n      \"type\": \"complex_workflow\",\n      \"steps\": [\"extract\", \"analyze\", \"summarize\"]\n  })\n  ```\n\n## Advanced Features\n\n### Memory Management\n```python\n# Store and retrieve context\nawait agent.enhanced_memory.store_semantic(\n    text=\"Important information\",\n    metadata={\"type\": \"research\"}\n)\n```\n\n### Load Balancing\n```python\n# Configure load balancing\nconfig = LoadBalancerConfig(\n    check_interval=30,\n    overload_threshold=0.8\n)\n```\n\n### Fault Tolerance\n```python\n# Configure fault tolerance\nconfig = FaultToleranceConfig(\n    recovery_attempts=3,\n    heartbeat_timeout=60\n)\n```\n\n## Project Structure\n\n```\npilott/\n├── core/            # Core framework components\n├── agents/          # Agent implementations\n├── memory/          # Memory management\n├── orchestration/   # System orchestration\n├── tools/           # Tool integrations\n└── utils/           # Utility functions\n```\n\n## Contributing\n\nWe welcome contributions! See our [Contributing Guide](.github/CONTRIBUTING.md) for details on:\n- Development setup\n- Coding standards\n- Pull request process\n\n## Support\n\n- 📚 [Documentation](https://docs.pilottai.com)\n- 💬 [Discord](https://discord.gg/pilottai) \u003c!-- TODO: Correct link --\u003e\n- 📝 [GitHub Issues](https://github.com/pilottai/pilott/issues)\n- 📧 [Email Support](mailto:support@pilottai.com)\n\n## License\n\nPilottAI is MIT licensed. See [LICENSE](LICENSE) for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eBuilt with ❤️ by the PilottAI Team\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpilottai%2Fpilottai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpilottai%2Fpilottai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpilottai%2Fpilottai/lists"}