{"id":27725214,"url":"https://github.com/TheAgenticAI/CortexON","last_synced_at":"2025-04-27T19:01:48.984Z","repository":{"id":282220348,"uuid":"946025961","full_name":"TheAgenticAI/CortexON","owner":"TheAgenticAI","description":"Open-source generalized AI agent for everyday task automations.","archived":false,"fork":false,"pushed_at":"2025-04-24T06:56:53.000Z","size":5559,"stargazers_count":434,"open_issues_count":11,"forks_count":55,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-24T07:46:36.621Z","etag":null,"topics":["ai-agents","automation","genai","llm","multi-agent","reasoning","reasoning-agent"],"latest_commit_sha":null,"homepage":"https://cortexon.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheAgenticAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2025-03-10T13:51:08.000Z","updated_at":"2025-04-24T02:29:00.000Z","dependencies_parsed_at":"2025-04-24T07:48:34.479Z","dependency_job_id":null,"html_url":"https://github.com/TheAgenticAI/CortexON","commit_stats":null,"previous_names":["theagenticai/cortexon"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAgenticAI%2FCortexON","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAgenticAI%2FCortexON/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAgenticAI%2FCortexON/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAgenticAI%2FCortexON/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheAgenticAI","download_url":"https://codeload.github.com/TheAgenticAI/CortexON/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251191489,"owners_count":21550140,"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":["ai-agents","automation","genai","llm","multi-agent","reasoning","reasoning-agent"],"created_at":"2025-04-27T19:01:46.896Z","updated_at":"2025-04-27T19:01:48.958Z","avatar_url":"https://github.com/TheAgenticAI.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"frontend/src/assets/CortexON_logo_dark.svg\" alt=\"CortexOn Logo\" width=\"500\"/\u003e\n\u003c/p\u003e\n\n# CortexON\n\n**An Open Source Generalized AI Agent for Advanced Research and Business Process Automation**\n\nCortexON is an open-source, multi-agent AI system inspired by advanced agent platforms such as Manus and OpenAI DeepResearch. Designed to seamlessly automate and simplify everyday tasks, CortexON excels at executing complex workflows including comprehensive research tasks, technical operations, and sophisticated business process automations.\n\n\u003cimg src=\"assets/cortexon_flow.png\" alt=\"CortexOn Logo\" width=\"1000\"/\u003e\n\n---\n\n## Table of Contents\n\n- [What is CortexON?](#what-is-cortexon)\n- [How It Works](#how-it-works)\n- [Key Capabilities](#key-capabilities)\n- [Technical Stack](#technical-stack)\n- [Quick Start Installation](#quick-start-installation)\n  - [Environment Variables](#environment-variables)\n  - [Docker Setup](#docker-setup)\n  - [Access Services](#access-services)\n- [Contributing](#contributing)\n- [Code of Conduct](#code-of-conduct)\n- [License](#license)\n\n---\n\n## What is CortexON?\n\nUnder the hood, CortexON integrates multiple specialized agents that dynamically collaborate to accomplish user-defined objectives. These specialized agents include:\n\n- **Web Agent:** Handles real-time internet searches, data retrieval, and web interactions.\n- **File Agent:** Manages file operations, organization, data extraction, and storage tasks.\n- **Coder Agent:** Generates, debugs, and optimizes code snippets across various programming languages.\n- **Executor Agent:** Executes tasks, manages workflows, and orchestrates inter-agent communications.\n- **API Agent:** Integrates seamlessly with external services, APIs, and third-party software to extend automation capabilities.\n\nTogether, these agents dynamically coordinate, combining their unique capabilities to effectively automate complex tasks.\n\n---\n\n## How It Works\n\n\u003cimg src=\"assets/cortexon_arch.png\" alt=\"CortexOn Logo\" width=\"1000\"/\u003e\n\n---\n\n## Key Capabilities\n- Advanced, context-aware research automation\n- Dynamic multi-agent orchestration\n- Seamless integration with third-party APIs and services\n- Code generation, debugging, and execution\n- Efficient file and data management\n- Personalized and interactive task execution, such as travel planning, market analysis, educational content creation, and business intelligence\n\n---\n\n## Technical Stack\n\nCortexON is built using:\n- **Framework:** PydanticAI multi-agent framework\n- **Headless Browser:** Browserbase (Web Agent)\n- **Search Engine:** Google SERP\n- **Logging \u0026 Observability:** Pydantic Logfire\n- **Backend:** FastAPI\n- **Frontend:** React/TypeScript, TailwindCSS, Shadcn\n\n---\n\n## Quick Start Installation\n\n### Environment Variables\n\nCreate a `.env` file with the following required variables:\n\n#### Anthropic API\n- `ANTHROPIC_MODEL_NAME=claude-3-7-sonnet-20250219`\n- `ANTHROPIC_API_KEY=your_anthropic_api_key`\n\nObtain your API key from [Anthropic Console](https://console.anthropic.com).\n\n#### Browserbase Configuration\n- `BROWSERBASE_API_KEY=your_browserbase_api_key`\n- `BROWSERBASE_PROJECT_ID=your_browserbase_project_id`\n\nSet up your account and project at [Browserbase](https://browserbase.com).\n\n#### Google Custom Search\n- `GOOGLE_API_KEY=your_google_api_key`\n- `GOOGLE_CX=your_google_cx_id`\n\nFollow the steps at [Google Custom Search API](https://developers.google.com/custom-search/v1/overview).\n\n#### Logging\n- `LOGFIRE_TOKEN=your_logfire_token`\n\nCreate your token at [LogFire](https://pydantic.dev/logfire).\n\n#### Vault Integration(OPTIONAL)\n- `VITE_APP_API_BASE_URL=http://localhost:8000`\n- `VITE_APP_VA_NAMESPACE=your_unique_namespace_id` (format unrestricted, UUID recommended)\n- `VA_TOKEN=your_vault_authentication_token`\n- `VA_URL=your_vault_service_endpoint`\n- `VA_TTL=24h`\n- `VA_TOKEN_REFRESH_SECONDS=43200`\n\nThis project uses HashiCorp Cloud Platform (HCP) Vault for secure secrets management. While you can either self-host Vault or use HCP Vault, we recommend using HCP Vault for the best managed experience. For HCP Vault Dedicated cluster setup, follow the [official HashiCorp documentation](https://developer.hashicorp.com/vault/tutorials/get-started-hcp-vault-dedicated/create-cluster).\n\n#### WebSocket\n- `VITE_WEBSOCKET_URL=ws://localhost:8081/ws`\n\n### Docker Setup\n\n1. Clone the CortexON repository:\n```sh\ngit clone https://github.com/TheAgenticAI/CortexOn.git\ncd CortexOn\n```\n\n2. Setup environment variables\n\n3. **Docker Desktop Users (Optional)**: Enable host networking in Docker Desktop settings ([Guide](https://docs.docker.com/engine/network/drivers/host/)).\n\n4. Build and run the Docker containers:\n```sh\ndocker-compose build\ndocker-compose up\n```\n\n### Access Services\n- **Frontend:** [http://localhost:3000](http://localhost:3000)\n- **CortexON Backend:** [http://localhost:8081](http://localhost:8081) | API Docs: [http://localhost:8081/docs](http://localhost:8081/docs)\n- **Agentic Browser:** [http://localhost:8000](http://localhost:8000) | API Docs: [http://localhost:8000/docs](http://localhost:8000/docs)\n\n---\n\n## Contributing\n\nWe welcome contributions from developers of all skill levels. Please see our [Contributing Guidelines](CONTRIBUTING.md) for detailed instructions.\n\n---\n\n## Code of Conduct\n\nWe are committed to providing a welcoming and inclusive environment for all contributors. Please adhere to our [Code of Conduct](CODE_OF_CONDUCT.md).\n\n---\n\n## License\n\nCortexON is licensed under the [CortexON Open Source License Agreement](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheAgenticAI%2FCortexON","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTheAgenticAI%2FCortexON","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheAgenticAI%2FCortexON/lists"}