CortexON

undefinedAn Open Source Generalized AI Agent for Advanced Research and Business Process Automationundefined

CortexON 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.

---

Table of Contents

• What is CortexON?
• How It Works
• Key Capabilities
• Technical Stack
• Quick Start Installation
  • Environment Variables
  • Docker Setup
  • Access Services
• Contributing
• Code of Conduct
• License

---

What is CortexON?

Under the hood, CortexON integrates multiple specialized agents that dynamically collaborate to accomplish user-defined objectives. These specialized agents include:

• undefinedWeb Agent: Handles real-time internet searches, data retrieval, and web interactions.
• undefinedFile Agent: Manages file operations, organization, data extraction, and storage tasks.
• undefinedCoder Agent: Generates, debugs, and optimizes code snippets across various programming languages.
• undefinedExecutor Agent: Executes tasks, manages workflows, and orchestrates inter-agent communications.
• undefinedAPI Agent: Integrates seamlessly with external services, APIs, and third-party software to extend automation capabilities.

Together, these agents dynamically coordinate, combining their unique capabilities to effectively automate complex tasks.

---

How It Works

---

Key Capabilities

• Advanced, context-aware research automation
• Dynamic multi-agent orchestration
• Seamless integration with third-party APIs and services
• Code generation, debugging, and execution
• Efficient file and data management
• Personalized and interactive task execution, such as travel planning, market analysis, educational content creation, and business intelligence

---

Technical Stack

CortexON is built using:

• undefinedFramework: PydanticAI multi-agent framework
• undefinedHeadless Browser: Browserbase (Web Agent)
• undefinedSearch Engine: Google SERP
• undefinedLogging & Observability: Pydantic Logfire
• undefinedBackend: FastAPI
• undefinedFrontend: React/TypeScript, TailwindCSS, Shadcn

---

Quick Start Installation

Environment Variables

Create a .env file with the following required variables:

Anthropic API

• ANTHROPIC_MODEL_NAME=claude-3-7-sonnet-20250219
• ANTHROPIC_API_KEY=your_anthropic_api_key

Obtain your API key from Anthropic Console.

Browserbase Configuration

• BROWSERBASE_API_KEY=your_browserbase_api_key
• BROWSERBASE_PROJECT_ID=your_browserbase_project_id

Set up your account and project at Browserbase.

Google Custom Search

• GOOGLE_API_KEY=your_google_api_key
• GOOGLE_CX=your_google_cx_id

Follow the steps at Google Custom Search API.

Logging

• LOGFIRE_TOKEN=your_logfire_token

Create your token at LogFire.

Vault Integration(OPTIONAL)

• VITE_APP_API_BASE_URL=http://localhost:8000
• VITE_APP_VA_NAMESPACE=your_unique_namespace_id (format unrestricted, UUID recommended)
• VA_TOKEN=your_vault_authentication_token
• VA_URL=your_vault_service_endpoint
• VA_TTL=24h
• VA_TOKEN_REFRESH_SECONDS=43200

This 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.

WebSocket

• VITE_WEBSOCKET_URL=ws://localhost:8081/ws

Docker Setup

1. Clone the CortexON repository:

git clone https://github.com/TheAgenticAI/CortexOn.git
cd CortexOn

2. Setup environment variables

3. undefinedDocker Desktop Users (Optional): Enable host networking in Docker Desktop settings (Guide).

4. Build and run the Docker containers:

docker-compose build
docker-compose up

Access Services

• undefinedFrontend: http://localhost:3000
• undefinedCortexON Backend: http://localhost:8081 | API Docs: http://localhost:8081/docs
• undefinedAgentic Browser: http://localhost:8000 | API Docs: http://localhost:8000/docs

---

Contributing

We welcome contributions from developers of all skill levels. Please see our Contributing Guidelines for detailed instructions.

---

Code of Conduct

We are committed to providing a welcoming and inclusive environment for all contributors. Please adhere to our Code of Conduct.

---

License

CortexON is licensed under the CortexON Open Source License Agreement.