gpt-researcher

Install as Claude Skill

Extend Claude's deep research capabilities by installing GPT Researcher as a Claude Skill:

npx skills add assafelovic/gpt-researcher

Once installed, Claude can leverage GPT Researcher's deep research capabilities directly within your conversations.

Installation

1. Install Python 3.11 or later. Guide.

2. Clone the project and navigate to the directory:

   git clone https://github.com/assafelovic/gpt-researcher.git
   cd gpt-researcher
   

3. Set up API keys by exporting them or storing them in a .env file.

   export OPENAI_API_KEY={Your OpenAI API Key here}
   export TAVILY_API_KEY={Your Tavily API Key here}
   

   (Optional) For enhanced tracing and observability, you can also set:

   # export LANGCHAIN_TRACING_V2=true
   # export LANGCHAIN_API_KEY={Your LangChain API Key here}
   

   For custom OpenAI-compatible APIs (e.g., local models, other providers), you can also set:

   export OPENAI_BASE_URL={Your custom API base URL here}
   

4. Install dependencies and start the server:

   pip install -r requirements.txt
   python -m uvicorn main:app --reload
   

Visit http://localhost:8000 to start.

For other setups (e.g., Poetry or virtual environments), check the Getting Started page.

Run with Docker

Step 1 - Install Docker

Step 2 - Clone the '.env.example' file, add your API Keys to the cloned file and save the file as '.env'

Step 3 - Within the docker-compose file comment out services that you don't want to run with Docker.

docker-compose up --build

If that doesn't work, try running it without the dash:

docker compose up --build

Step 4 - By default, if you haven't uncommented anything in your docker-compose file, this flow will start 2 processes:

• the Python server running on localhost:8000
  
• the React app running on localhost:3000
  

Visit localhost:3000 on any browser and enjoy researching!