iflow-mcp_OctagonAI-octagon-vc-agents 0.1.6__py3-none-any.whl

iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/METADATA

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_OctagonAI-octagon-vc-agents
+Version: 0.1.6
+Summary: MCP server that runs AI-driven venture capitalist agents, enriched by Octagon Private Markets' real-time intelligence
+Project-URL: Homepage, https://github.com/OctagonAI/octagon-vc-agents
+Project-URL: Documentation, https://docs.octagonagents.com
+Project-URL: Repository, https://github.com/OctagonAI/octagon-vc-agents.git
+Project-URL: Issues, https://github.com/OctagonAI/octagon-vc-agents/issues
+Author-email: Octagon AI <support@octagonagents.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,investment,startup,venture capital
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: mcp
+Requires-Dist: openai
+Requires-Dist: openai-agents
+Requires-Dist: pydantic
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: typer
+Requires-Dist: uvicorn
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: ipython>=9.0.2; extra == 'dev'
+Requires-Dist: isort; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Octagon VC Agents
+
+[![smithery badge](https://smithery.ai/badge/@OctagonAI/octagon-vc-agents)](https://smithery.ai/server/@OctagonAI/octagon-vc-agents)
+
+An MCP server that runs AI-driven venture capitalist agents (Fred Wilson, Peter Thiel, etc.), whose thinking is continuously enriched by Octagon Private Markets' real-time deals, valuations, and deep research intelligence. Use it to spin up programmable "VC brains" for pitch feedback, diligence simulations, term sheet negotiations, and more.
+
+<!-- Display at 60% wide and keep the aspect ratio -->
+<img src="https://docs.octagonagents.com/octagon-vc-agents.png"
+     alt="Octagon VC Agents"
+     width="60%" />
+    
+## Try Demo in ChatGPT
+VC Agents are also fully integrated them in ChatGPT with a demo Octagon API key. Give them a try here:
+<a href="https://chatgpt.com/g/g-680c1eddd1448191bb4ed7e09485270f-vc-agents" target="_blank" rel="noopener noreferrer">VC Agents GPT</a>
+
+
+## Octagon VC Agents
+
+These are AI-powered simulations inspired by notable venture capitalists. These personas are not affiliated with or endorsed by the actual individuals.
+
+| VC Agent Name | Description |
+|------------|-------------|
+| [`octagon-marc-andreessen-agent`](src/octagon_vc_agents/investors/marc_andreessen.md) | Simulation of the tech-optimist investor known for "software eating the world" thesis and bold technology bets |
+| [`octagon-peter-thiel-agent`](src/octagon_vc_agents/investors/peter_thiel.md) | Simulation of the venture capitalist & 'Zero to One' author who analyzes investments through the lens of monopoly theory and contrarian thinking |
+| [`octagon-reid-hoffman-agent`](src/octagon_vc_agents/investors/reid_hoffman.md) | Simulation of the LinkedIn founder-turned-investor known for network-effect businesses and blitzscaling philosophy |
+| [`octagon-keith-rabois-agent`](src/octagon_vc_agents/investors/keith_rabois.md) | Simulation of the operator-investor known for spotting exceptional talent and operational excellence |
+| [`octagon-bill-gurley-agent`](src/octagon_vc_agents/investors/bill_gurley.md) | Simulation of the analytical investor known for marketplace expertise and detailed market analysis |
+| [`octagon-fred-wilson-agent`](src/octagon_vc_agents/investors/fred_wilson.md) | Simulation of the USV co-founder & veteran early-stage investor focused on community-driven networks and founder-first philosophies |
+| [`octagon-josh-kopelman-agent`](src/octagon_vc_agents/investors/josh_kopelman.md) | Simulation of the founder-friendly investor focused on seed-stage companies and founder development |
+| [`octagon-alfred-lin-agent`](src/octagon_vc_agents/investors/alfred_lin.md) | Simulation of the operator-turned-investor known for consumer businesses and organizational scaling |
+
+## Example Prompts
+
+| What you want from the agents | Copy-and-paste prompt |
+|-------------------------------|-----------------------|
+| Deal critique                 | Ask `@octagon-marc-andreessen-agent` and `@octagon-reid-hoffman-agent` to evaluate {company website}'s latest funding round. Provide a detailed comparative table from their points of view. |
+| Qualify investor fit before the call | `@octagon-alfred-lin-agent` You're vetting my pre-seed startup: {one-sentence pitch}. In {deck.pdf}, you'll find our vision, team, and WAU chart. Give me a "meet/pass" decision and list the three metrics I should strengthen most before your partner vote on Monday. |
+| Thesis & metrics reality-check | `@octagon-reid-hoffman-agent` Here's our 10-slide deck and dashboard ({docs}). We currently have {X} weekly active users, {Y}% MoM WAU growth, and {Z}% retention over 8 weeks. Using your 14-day diligence lens, list the biggest metric gaps that would prevent you from issuing a term sheet, and suggest how we could close them within one quarter. |
+| Portfolio-intro mapping – warm leads for the next round | `@octagon-fred-wilson-agent` Based on your current portfolio in {data} and our focus (outlined in the one-pager below), identify four portfolio CEOs who could become design partners. For each CEO, draft a first-contact email from me that highlights mutual value. |
+
+## Prerequisites
+
+To use Octagon VC Agents, you will need **two API keys**:
+- An **Octagon API key** (for access to Octagon Private Markets data)
+- An **OpenAI API key** (for AI-powered analysis)
+
+### Get Your Octagon API Key
+
+To use VC Agents, you need to:
+
+1. Sign up for a free account at [Octagon](https://app.octagonai.co/signup/?redirectToAfterSignup=https://app.octagonai.co/api-keys)
+2. After logging in, from left menu, navigate to **API Keys**
+3. Generate a new API key
+4. Use this API key in your configuration as the `OCTAGON_API_KEY` value
+
+### Get Your OpenAI API Key
+
+You also need an OpenAI API key to enable AI-powered features:
+
+1. Sign up or log in at [OpenAI](https://platform.openai.com/signup)
+2. Go to [API Keys](https://platform.openai.com/api-keys)
+3. Create a new API key
+4. Use this API key in your configuration as the `OPENAI_API_KEY` value
+
+### Install pipx
+
+To use Octagon VC Agents, you need [pipx](https://pypa.github.io/pipx/), a tool for installing and running Python applications in isolated environments.
+
+#### On macOS
+Install pipx using Homebrew (recommended):
+```bash
+brew install pipx
+pipx ensurepath
+```
+Or with pip:
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+```
+
+#### On Windows
+Install pipx using pip:
+```powershell
+python -m pip install --user pipx
+python -m pipx ensurepath
+```
+After installation, restart your terminal so that the `pipx` command is available.
+
+
+## Installation
+
+### Running on Claude Desktop
+
+To configure Octagon VC Agents for Claude Desktop:
+
+1. Open Claude Desktop
+2. Go to Settings > Developer > Edit Config
+3. Add the following to your `claude_desktop_config.json` (Replace `YOUR_OCTAGON_API_KEY_HERE` with your Octagon API key and `YOUR_OPENAI_API_KEY_HERE` with your OpenAI API key):
+```json
+{
+  "mcpServers": {
+    "octagon-vc-agents": {
+      "command": "pipx",
+      "args": ["run", "--pip-args=\"--no-cache-dir\"", "octagon-vc-agents", "run"],
+      "env": {
+        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
+        "OCTAGON_API_KEY": "YOUR_OCTAGON_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+4. Restart Claude for the changes to take effect
+
+
+
+### Running on Cursor
+
+Configuring Cursor Desktop 🖥️
+Note: Requires Cursor version 0.45.6+
+
+To configure Octagon VC Agents in Cursor:
+
+1. Open Cursor Settings
+2. Go to Features > MCP Servers 
+3. Click "+ Add New MCP Server"
+4. Enter the following:
+   - Name: "octagon-mcp" (or your preferred name)
+   - Type: "command"
+   - Command: `env OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE pipx run --pip-args="--no-cache-dir" octagon-vc-agents run`
+
+> If you are using Windows and are running into issues, try `cmd /c "set OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE && set OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE && pipx run --pip-args='--no-cache-dir' octagon-vc-agents run"`
+
+Replace `YOUR_OCTAGON_API_KEY_HERE` with your Octagon API key and `YOUR_OPENAI_API_KEY_HERE` with your OpenAI API key.
+
+After adding, refresh the MCP server list to see the new tools. The Composer Agent will automatically use VC Agents when appropriate, but you can explicitly request it by describing your investment research needs. Access the Composer via Command+L (Mac), select "Agent" next to the submit button, and enter your query.
+
+
+### Running on Windsurf
+
+Add this to your `./codeium/windsurf/model_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "octagon-vc-agents": {
+      "command": "pipx",
+      "args": ["run", "--pip-args=\"--no-cache-dir\"", "octagon-vc-agents", "run"],
+      "env": {
+        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
+        "OCTAGON_API_KEY": "YOUR_OCTAGON_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+
+### Running with pipx
+
+```bash
+env OCTAGON_API_KEY=YOUR_OCTAGON_API_KEY_HERE OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE pipx run --pip-args="--no-cache-dir" octagon-vc-agents run
+```
+
+### Manual Installation
+
+```bash
+pip install octagon-vc-agents
+```
+    
+## Implementation Details
+
+### Persona Configuration
+
+Investor personas are defined through markdown files containing:
+- Investment philosophy
+- Psychological profile
+- Historical track record
+- Decision-making patterns
+- Communication style preferences
+
+### Customization Options
+
+1. Add new investor personas by creating markdown profiles
+2. Implement custom interaction patterns between personas
+3. Enhance orchestration logic for complex multi-perspective analysis
+
+
+## Documentation
+
+For detailed information about Octagon Agents, including setup guides, API reference, and best practices, visit our [documentation](https://docs.octagonagents.com).
+
+## License
+MIT
+

iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/RECORD

@@ -0,0 +1,21 @@
+octagon_vc_agents/__init__.py,sha256=Sfm8dbEKCPUDwkWqIUqkg3JSPl5Gk72STg82_3dUDdI,165
+octagon_vc_agents/__main__.py,sha256=WPf0Zq2ICiCBG_4_0PKpdZ1xTyboKhrNWC0mkn71ARg,1124
+octagon_vc_agents/agent_registrar.py,sha256=o4Sch0FFmvw8xnhkmFY7G6rCNGIB1PPXnAtCAA9U7_Q,2856
+octagon_vc_agents/cli.py,sha256=U_HfUKZGUeoP064OqQSceX6QZanhiTD09eVPOQIDh8k,5233
+octagon_vc_agents/client.py,sha256=ad5qaOU8IHM6ChoJ_SJABLsZdE-DfBTVq-qtlwo2tik,746
+octagon_vc_agents/openai_agents.py,sha256=nhx0r3cuaGBsHnBRe_JUQL4s2PImZIo-Ro-FEQcS3m0,7052
+octagon_vc_agents/server.py,sha256=-TGi35ENap7O6N1InHUc7KfhHrg4n7qNIaXJrHZ05CY,986
+octagon_vc_agents/vc_agents.py,sha256=1D_dw9BU5Hv4PdHBRFLPUeX9wan3vHgSTfZ8mn8wMJs,1436
+octagon_vc_agents/investors/alfred_lin.md,sha256=orpzGsNu0UjBUMtzlyFWaO6U7GPqBRD3v0ataURBiwk,13480
+octagon_vc_agents/investors/bill_gurley.md,sha256=Be1nR-aT16lmC_nhpztBAvmyDthwIkO1PmWxzMaLpB0,13065
+octagon_vc_agents/investors/fred_wilson.md,sha256=hOKJA9FgC3K1iDMlRJ0TYIsbIYFTa9_TvCy1ZGQHAUQ,16229
+octagon_vc_agents/investors/josh_kopelman.md,sha256=EXbT6v0vqKZ7R444TB5wNfAgoODonwmtJCfBC2jRUFs,14547
+octagon_vc_agents/investors/keith_rabois.md,sha256=2Rusz-hL-8xPlDzMIY4mfpmaaV8eTTNLhwlG0w9cT2Y,13939
+octagon_vc_agents/investors/marc_andreessen.md,sha256=CBJAC7ZSKYpwPzXNPM1NxfRPjFTeKaZNHMgEJM5Kvxs,15420
+octagon_vc_agents/investors/peter_thiel.md,sha256=LxA86xREa7aT4ifQSG2P-A5ixlO1zBimSrTLe2Nm1rU,15348
+octagon_vc_agents/investors/reid_hoffman.md,sha256=uJYj3Q54KDj8a3VII6j9dX7Smidi55AxRQRZOvL-8Co,13175
+iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/METADATA,sha256=v-0JAGJboIk1TtTCfYj-S5IjkZH2vBMySPCL_lOAxLY,10247
+iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/entry_points.txt,sha256=koZmpMpNXJQ4w9guIdpQLkUE7GSMRfx0hOkjRCmuGWo,65
+iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/licenses/LICENSE,sha256=JStnDfH22ZZI5bH9Fvf-j5jNQVSJAZ4l_-46t0_ph3U,1073
+iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/RECORD,,

iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+octagon_vc_agents = octagon_vc_agents.cli:main

iflow_mcp_octagonai_octagon_vc_agents-0.1.6.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Octagon AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

octagon_vc_agents/__init__.py

@@ -0,0 +1,9 @@
+"""
+Octagon VC Agents - AI-driven venture capitalist agents powered by Octagon Private Markets
+"""
+
+__version__ = "0.1.0"
+
+from .cli import main
+
+__all__ = ["main"]

octagon_vc_agents/__main__.py

@@ -0,0 +1,38 @@
+"""
+Main entry point for the Octagon octagon-vc-agents.
+
+This module provides the main entry point for running the MCP server.
+"""
+
+import os
+import sys
+
+from octagon_vc_agents.server import mcp
+
+
+def main() -> None:
+    """Run the MCP server."""
+    # Check if the OpenAI API key is set
+    if not os.environ.get("OPENAI_API_KEY"):
+        print("Error: OPENAI_API_KEY environment variable is not set.")
+        print("Please set it before running the server.")
+        sys.exit(1)
+
+    # Check if the Octagon API key is set
+    if not os.environ.get("OCTAGON_API_KEY"):
+        print("Error: OCTAGON_API_KEY environment variable is not set.")
+        print("Obtain your API key at https://app.octagonai.co/signup")
+        print("Please set it before running the server.")
+        sys.exit(1)
+    
+    # Get the transport from environment variables or use default
+    transport = os.environ.get("MCP_TRANSPORT", "stdio")
+
+    print(f"Starting OpenAI Agents MCP server with {transport} transport")
+
+    # Run the server using the FastMCP's run method
+    mcp.run(transport=transport)
+
+
+if __name__ == "__main__":
+    main()

octagon_vc_agents/agent_registrar.py

@@ -0,0 +1,71 @@
+
+from typing import Callable
+from pydantic import BaseModel, Field
+from mcp.server.fastmcp import FastMCP
+from agents import Runner, trace, ItemHelpers, MessageOutputItem, Agent
+
+class AgentResponse(BaseModel):
+    response: str
+
+class AgentRegistrar:
+    def __init__(self, mcp: FastMCP):
+        self.mcp = mcp
+
+    def register(
+        self,
+        *,
+        name: str,
+        description: str,
+        build_agent: Callable[[], object],
+        vc_agent: bool = False,
+        has_field_description: bool = False,
+        octagon_activated: bool = False
+    ):
+        """
+        Registers an agent as an MCP tool.
+
+        Args:
+            name (str): Display name of the agent (used in tool name).
+            description (str): Description shown in the tool.
+            build_agent (Callable): Function that returns an initialized Agent.
+            traced (bool): Whether to wrap the agent run in a tracing context.
+            has_field_description (bool): Whether to apply a field-level description to the input.
+        """
+        agent = build_agent()
+        tool_name = f"octagon-{name.lower().replace(' ', '-')}-agent"
+
+        # Conditionally define the tool with or without input field metadata
+        if has_field_description:
+            @self.mcp.tool(name=tool_name, description=description)
+            async def _tool(query: str = Field(..., description="Investment-related question or query.")) -> AgentResponse:
+                return await self._run_agent(agent, query, name, vc_agent)
+        else:
+            @self.mcp.tool(name=tool_name, description=description)
+            async def _tool(query: str) -> AgentResponse:
+                return await self._run_agent(agent, query, name, vc_agent)
+
+    async def _run_agent(self, agent, query: str, name: str, vc_agent: bool) -> AgentResponse:
+        try:
+            if vc_agent:
+                with trace(f"{name} analysis"):
+                    # Agent runs first, fetching data internally via tools
+                    orchestrator_result = await Runner.run(agent, query)
+
+                    # Capture interim outputs (stock data fetched)
+                    for item in orchestrator_result.new_items:
+                        if isinstance(item, MessageOutputItem):
+                            text = ItemHelpers.text_message_output(item)
+                            if text:
+                                print(f"  - Data fetched: {text}")
+                    
+                    final_output = orchestrator_result.final_output
+            else:
+                # Regular agent execution without orchestration
+                result = await Runner.run(agent, query)
+                final_output = result.final_output
+
+            return AgentResponse(response=final_output)
+
+        except Exception as e:
+            return AgentResponse(response=str(e))
+

octagon_vc_agents/cli.py

@@ -0,0 +1,160 @@
+"""
+Command-line interface for the Octagon VC Agents.
+
+This module provides a command-line interface for running and installing the MCP server.
+"""
+
+import getpass
+import json
+import os
+import platform
+import sys
+from pathlib import Path
+from typing import Dict, List, Optional
+
+import typer
+from openai import OpenAI
+from rich.console import Console
+
+from .server import mcp  # Import the MCP server instance directly
+from .client import octagon_client  # Import the Octagon client instance
+
+app = typer.Typer(help="Octagon VC Agents - AI-driven venture capitalist agents powered by Octagon Private Markets")
+console = Console()
+
+
+def which(cmd: str, path: Optional[str] = None) -> Optional[str]:
+    """Find the path to an executable."""
+    if path is None:
+        path = os.environ.get("PATH", "")
+
+    if platform.system() == "Windows":
+        cmd = cmd + ".exe"
+        paths = path.split(";")
+    else:
+        paths = path.split(":")
+
+    for p in paths:
+        cmd_path = os.path.join(p, cmd)
+        if os.path.isfile(cmd_path) and os.access(cmd_path, os.X_OK):
+            return cmd_path
+
+    return None
+
+
+def update_claude_config(
+    server_name: str, command: str, args: List[str], env_vars: Optional[Dict[str, str]] = None
+) -> bool:
+    """Update the Claude desktop app configuration to include this server."""
+    # Find the Claude config file
+    config_file = None
+    if platform.system() == "Darwin":  # macOS
+        config_file = Path(
+            Path.home(), "Library", "Application Support", "Claude", "servers_config.json"
+        )
+    elif platform.system() == "Windows":
+        config_file = Path(Path.home(), "AppData", "Roaming", "Claude", "servers_config.json")
+    elif platform.system() == "Linux":
+        config_file = Path(Path.home(), ".config", "Claude", "servers_config.json")
+
+    if not config_file:
+        console.print("[bold red]Error:[/] Could not determine Claude config file location.")
+        return False
+
+    # Create the config file if it doesn't exist
+    config_file.parent.mkdir(parents=True, exist_ok=True)
+    if not config_file.exists():
+        config_file.write_text("{}")
+
+    try:
+        config = json.loads(config_file.read_text())
+        if "mcpServers" not in config:
+            config["mcpServers"] = {}
+
+        # Always preserve existing env vars and merge with new ones
+        if server_name in config["mcpServers"] and "env" in config["mcpServers"][server_name]:
+            existing_env = config["mcpServers"][server_name]["env"]
+            if env_vars:
+                # New vars take precedence over existing ones
+                env_vars = {**existing_env, **env_vars}
+            else:
+                env_vars = existing_env
+
+        server_config = {"command": command, "args": args}
+
+        # Add environment variables if specified
+        if env_vars:
+            server_config["env"] = env_vars
+
+        config["mcpServers"][server_name] = server_config
+
+        config_file.write_text(json.dumps(config, indent=2))
+        console.print(f"[bold green]Success:[/] Added server '{server_name}' to Claude config")
+        return True
+    except Exception as e:
+        console.print(f"[bold red]Error:[/] Failed to update Claude config: {str(e)}")
+        return False
+
+
+@app.command()
+def run() -> None:
+    """Run the Octagon Investor Agents Tool MCP server."""
+    mcp.run()
+
+
+@app.command()
+def install() -> None:
+    """Install the server in the Claude desktop app."""
+    name = "octagon-vc-agents"
+
+    env_dict = {}
+    local_bin = Path(Path.home(), ".local", "bin")
+    pyenv_shims = Path(Path.home(), ".pyenv", "shims")
+    path = os.environ["PATH"]
+    python_version = platform.python_version()
+    python_bin = Path(Path.home(), "Library", "Python", python_version, "bin")
+
+    if platform.system() == "Windows":
+        env_dict["PATH"] = f"{local_bin};{pyenv_shims};{python_bin};{path}"
+    else:
+        env_dict["PATH"] = f"{local_bin}:{pyenv_shims}:{python_bin}:{path}"
+
+    api_key = os.environ.get("OPENAI_API_KEY", "")
+    while not api_key:
+        api_key = getpass.getpass("Enter your OpenAI API key: ")
+        if api_key:
+            client = OpenAI(api_key=api_key)
+            try:
+                client.models.list()
+            except Exception as e:
+                console.print(
+                    f"[bold red]Error:[/] Failed to authenticate with OpenAI API: {str(e)}"
+                )
+                api_key = ""
+
+    env_dict["OPENAI_API_KEY"] = api_key
+
+    # Add Octagon API key
+    octagon_api_key = os.environ.get("OCTAGON_API_KEY", "")
+    while not octagon_api_key:
+        octagon_api_key = getpass.getpass("Enter your Octagon API key: ")
+    env_dict["OCTAGON_API_KEY"] = octagon_api_key
+
+    uv = which("uvx", path=env_dict["PATH"])
+    command = uv if uv else "uvx"
+    args = [name]
+
+    if update_claude_config(name, command, args, env_vars=env_dict):
+        console.print(f"[bold green]Success:[/] Successfully installed {name} in Claude app")
+    else:
+        console.print(f"[bold red]Error:[/] Failed to install {name} in Claude app")
+        sys.exit(1)
+
+
+def main():
+    """Entry point for the CLI when installed via pip/pipx."""
+    app()
+
+
+if __name__ == "__main__":
+    main()

octagon_vc_agents/client.py

@@ -0,0 +1,25 @@
+"""
+Octagon client configuration and initialization.
+"""
+
+import os
+import sys
+from openai import AsyncOpenAI
+from rich.console import Console
+
+console = Console()
+
+def get_octagon_client() -> AsyncOpenAI:
+    """Initialize and return Octagon client with current environment variables"""
+    api_key = os.environ.get("OCTAGON_API_KEY")
+    if not api_key:
+        console.print("[bold red]Error:[/] OCTAGON_API_KEY environment variable is not set")
+        console.print("Please set it using: export OCTAGON_API_KEY=your_api_key")
+        sys.exit(1)
+    
+    return AsyncOpenAI(
+        api_key=api_key,
+        base_url=os.environ.get("OCTAGON_BASE_URL", "https://api-gateway.octagonagents.com/v1")
+    )
+
+octagon_client = get_octagon_client()