CortexON

An Open Source Generalized AI Agent for Advanced Research and Business Process Automation

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:

• Web Agent: Handles real-time internet searches, data retrieval, and web interactions.
• File Agent: Manages file operations, organization, data extraction, and storage tasks.
• Coder Agent: Generates, debugs, and optimizes code snippets across various programming languages.
• Executor Agent: Executes tasks, manages workflows, and orchestrates inter-agent communications.
• API 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:

• Framework: PydanticAI multi-agent framework
• Headless Browser: Browserbase (Web Agent)
• Search Engine: Google SERP
• Logging & Observability: Pydantic Logfire
• Backend: FastAPI
• Frontend: React/TypeScript, TailwindCSS, Shadcn

---

Quick Start Installation

Environment Variables

Create a .env file with the following required variables:

Anthropic API

• ANTHROPICMODELNAME=claude-3-7-sonnet-20250219
• ANTHROPICAPIKEY=youranthropicapi_key

Obtain your API key from Anthropic Console.

Browserbase Configuration

• BROWSERBASEAPIKEY=yourbrowserbaseapi_key
• BROWSERBASEPROJECTID=yourbrowserbaseproject_id

Set up your account and project at Browserbase.

Google Custom Search

• GOOGLEAPIKEY=yourgoogleapi_key
• GOOGLECX=yourgooglecxid

Follow the steps at Google Custom Search API.

Logging

• LOGFIRETOKEN=yourlogfire_token

Create your token at LogFire.

Vault Integration(OPTIONAL)

• VITEAPPAPIBASEURL=http://localhost:8000
• VITEAPPVANAMESPACE=youruniquenamespaceid (format unrestricted, UUID recommended)
• VATOKEN=yourvaultauthenticationtoken
• VAURL=yourvaultserviceendpoint
• VA_TTL=24h
• VATOKENREFRESH_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

• VITEWEBSOCKETURL=ws://localhost:8081/ws

Docker Setup

• Clone the CortexON repository:

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

• Setup environment variables

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

• Build and run the Docker containers:

docker-compose build
docker-compose up

Access Services

• Frontend: http://localhost:3000
• CortexON Backend: http://localhost:8081 | API Docs: http://localhost:8081/docs
• Agentic 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.