Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/koushiknavuluri/claude-api

This project provides an unofficial API for Claude AI, allowing users to access and interact with Claude AI .
https://github.com/koushiknavuluri/claude-api

ai api chatbot chatgpt claude-ai claude-api python

Last synced: about 17 hours ago
JSON representation

This project provides an unofficial API for Claude AI, allowing users to access and interact with Claude AI .

Host: GitHub
URL: https://github.com/koushiknavuluri/claude-api
Owner: KoushikNavuluri
License: mit
Created: 2023-07-16T11:45:17.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-08-17T12:46:18.000Z (4 months ago)
Last Synced: 2024-12-26T14:03:58.942Z (about 17 hours ago)
Topics: ai, api, chatbot, chatgpt, claude-ai, claude-api, python
Language: Python
Homepage: https://pypi.org/project/claude-api/
Size: 58.6 KB
Stars: 776
Watchers: 20
Forks: 127
Open Issues: 28
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Claude AI-API ( Unofficial )

This project provides an unofficial API for Claude AI, allowing users to access and interact with Claude AI .



#### Current Version == 1.0.17 ( Added Timeouts,Faster Requests,File handling Fixed.. )

## Table of contents

  * [Use Cases](#use-cases)

  * [Prerequisites](#prerequisites)

  * [Installation](#installation)

  * [Usage](#usage)

  * [List All Conversations](#list-all-conversations)

  * [Send Message](#send-message)

  * [Send Message with attachment](#send-message-with-attachment)

  * [Delete Conversation](#delete-conversation)

  * [Chat Conversation History](#chat-conversation-history)

  * [Create New Chat](#create-new-chat)

  * [Reset All Conversations](#reset-all-conversations)

  * [Rename Chat](#rename-chat)

  * [Disclaimer](#disclaimer)

## Use Cases 

    1. Python Console ChatBot ( Check in usecases folder for sample console chatbot )

    2. Discord Chatbot   

    

    3. Many more can be done....

    

## Prerequisites

To use this API, you need to have the following:

Python installed on your system

requests library installed 

```bash

  pip install requests

```

## Installation

To use the Claude AI Unofficial API, you can either clone the GitHub repository or directly download the Python file.

Terminal :

    pip install claude-api

    

or

Clone the repository:

    git clone https://github.com/KoushikNavuluri/Claude-API.git

## Usage

Import the claude_api module in your Python script:

    from claude_api import Client

* Next, you need to create an instance of the Client class by providing your Claude AI cookie:

* You can get cookie from the browser's developer tools network tab ( see for any claude.ai requests check out cookie ,copy whole value ) or storage tab ( You can find cookie of claude.ai ,there will be four values )

* (Checkout below image for the format of cookie ,It is Better to Use from network tab to grab cookie easily )

   ![Screenshot (8)](https://github.com/KoushikNavuluri/Claude-API/assets/103725723/355971e3-f46c-47fc-a3cf-008bb55bb4c6)

      cookie = os.environ.get('cookie')

      claude_api = Client(cookie)

## List All Conversations

To list all the conversation Id's you had with Claude , you can use the list_all_conversations method:

    conversations = claude_api.list_all_conversations()

    for conversation in conversations:

        conversation_id = conversation['uuid']

        print(conversation_id)

## Send Message

To send a message to Claude, you can use the send_message method. You need to provide the prompt and the conversation ID:

    prompt = "Hello, Claude!"

    conversation_id = "" or claude_api.create_new_chat()['uuid']

    response = claude_api.send_message(prompt, conversation_id)

    print(response)

## Send Message with attachment

You can send any type of attachment to claude to get responses using attachment argument in send_message().

Note: Claude currently supports only some file types.

{ You can also add timeout if you need ,using timeout parameter[default set to 500] }

    prompt = "Hey,Summarize me this document.!"

    conversation_id = "" or claude_api.create_new_chat()['uuid']

    response = claude_api.send_message(prompt, conversation_id,attachment="path/to/file.pdf",timeout=600)

    print(response)

## Delete Conversation

To delete a conversation, you can use the delete_conversation method:

    conversation_id = ""

    deleted = claude_api.delete_conversation(conversation_id)

    if deleted:

        print("Conversation deleted successfully")

    else:

        print("Failed to delete conversation")

## Chat Conversation History

To get the chat conversation history, you can use the chat_conversation_history method:    

    conversation_id = ""

    history = claude_api.chat_conversation_history(conversation_id)

    print(history)

## Create New Chat

To create a new chat conversation (id), you can use the create_new_chat method:

    new_chat = claude_api.create_new_chat()

    conversation_id = new_chat['uuid']

    print(conversation_id)

## Reset All Conversations

To reset all conversations, you can use the reset_all method:

    reset = claude_api.reset_all()

    if reset:

        print("All conversations reset successfully")

    else:

        print("Failed to reset conversations")   

## Rename Chat

To rename a chat conversation, you can use the rename_chat method:

    conversation_id = ""

    title = "New Chat Title"

    renamed = claude_api.rename_chat(title, conversation_id)

    if renamed:

        print("Chat conversation renamed successfully")

    else:

        print("Failed to rename chat conversation")

## Disclaimer

This project provides an unofficial API for Claude AI and is not affiliated with or endorsed by Claude AI or Anthropic. Use it at your own risk.

Please refer to the official Claude AI documentation[https://claude.ai/docs] for more information on how to use Claude AI.