Package: unofficial-claude2-api
unofficial-claude2-apiTable of ContentsInstallationRequirementsExample UsageTipsRetrieving Chat HistoryFaster LoadingProxiesSwitching model versionTroubleshootingDonatingWhat is this?This unofficial Python API provides access to the conversational capabilities of Anthropic's Claude AI through a simple chat messaging interface.While not officially supported by Anthropic, this library can enable interesting conversational applications.It allows for:Creating chat sessions with Claude and getting chat IDs.Sending messages to Claude containing up to 5 attachment files (txt, pdf, csv, etc...) 10 MB each.Retrieving chat message history, accessing specific chat conversations.Deleting old chats when they are no longer needed.Sending requests through proxies.Some of the key things you can do with Claude through this APIAsk questions about a wide variety of topics. Claude can chat about current events, pop culture, sports,
and more.Get helpful explanations on complex topics. Ask Claude to explain concepts and ideas in simple terms.Generate summaries from long text or documents. Just give the filepath as an attachment to Claude and get back a concise summary.Receive thoughtful responses to open-ended prompts and ideas. Claude can brainstorm ideas, expand on concepts, and have philosophical discussions.How to installpipinstallunofficial-claude2-apiUninstallationpipuninstallunofficial-claude2-apiRequirementsThese requirements are needed to auto retrieve a SessionData object using seleniumPython >= 3.10Firefox installed, and with at least one profile logged intoClaude.geckodriverinstalled inside a folder registered in PATH environment variable.( scrolling through this README you'll find also a manual alternative )Example Usagefromsysimportexitassys_exitfromclaude2_api.clientimport(ClaudeAPIClient,SendMessageResponse,)fromclaude2_api.sessionimportSessionData,get_session_datafromclaude2_api.errorsimportClaudeAPIError,MessageRateLimitError,OverloadError# Wildcard import will also work the same as above# from claude2_api import *# List of attachments filepaths, up to 5, max 10 MB eachFILEPATH_LIST=["test1.txt","test2.txt",]# This function will automatically retrieve a SessionData instance using selenium# It will auto gather cookie session, user agent and organization ID.# Omitting profile argument will use default Firefox profilesession:SessionData=get_session_data()# Initialize a client instance using a session# Optionally change the requests timeout parameter to best fit your needs...default to 240 seconds.client=ClaudeAPIClient(session,timeout=240)# Create a new chat and cache the chat_idchat_id=client.create_chat()ifnotchat_id:# This will not throw MessageRateLimitError# But it still means that account has no more messages left.print("\nMessage limit hit, cannot create chat...")sys_exit(1)try:# Used for sending message with or without attachments# Returns a SendMessageResponse instanceres:SendMessageResponse=client.send_message(chat_id,"Hello!",attachment_paths=FILEPATH_LIST)# Inspect answerifres.answer:print(res.answer)else:# Inspect response status code and raw answer bytesprint(f"\nError code{res.status_code}, raw_answer:{res.raw_answer}")exceptClaudeAPIErrorase:# Identify the errorifisinstance(e,MessageRateLimitError):# The exception will hold these informations about the rate limit:print(f"\nMessage limit hit, resets at{e.reset_date}")print(f"\n{e.sleep_sec}seconds left until ->{e.reset_timestamp}")elifisinstance(e,OverloadError):print(f"\nOverloaded error:{e}")else:print(f"\nGot unknown Claude error:{e}")finally:# Perform chat deletion for cleanupclient.delete_chat(chat_id)# Get a list of all chats idsall_chat_ids=client.get_all_chat_ids()# Delete all chatsforchatinall_chat_ids:client.delete_chat(chat)# Or by using a shortcut utilityclient.delete_all_chats()sys_exit(0)TipsRetrieving chat history# A convenience method to access a specific chat conversation ischat_data=client.get_chat_data(chat_id)chat_datawill be the same json dictionary returned by calling/api/organizations/{organization_id}/chat_conversations/{chat_id}Here's an example of this json:{"uuid":"<ConversationUUID>","name":"","summary":"","model":null,"created_at":"1997-12-25T13:33:33.959409+00:00","updated_at":"1997-12-25T13:33:39.487561+00:00","chat_messages":[{"uuid":"<MessageUUID>","text":"Who is Bugs Bunny?","sender":"human","index":0,"created_at":"1997-12-25T13:33:39.487561+00:00","updated_at":"1997-12-25T13:33:40.959409+00:00","edited_at":null,"chat_feedback":null,"attachments":[]},{"uuid":"<MessageUUID>","text":"<Claude response's text>","sender":"assistant","index":1,"created_at":"1997-12-25T13:33:40.959409+00:00","updated_at":"1997-12-25T13:33:42.487561+00:00","edited_at":null,"chat_feedback":null,"attachments":[]}]}Faster loading, avoiding seleniumIf for whatever reason you'd like to avoid auto session gathering using selenium,
you just need to manually create aSessionDataclass forClaudeAPIClientconstructor, like so...fromclaude2_api.sessionimportSessionDatacookie_header_value="The entire Cookie header value string when you visit https://claude.ai/chats"user_agent="User agent to use, required"# You can retrieve this string from /api/organizations endpoint# If omitted or None it will be auto retrieved when instantiating ClaudeAPIClientorganization_id="<org_uuid>"session=SessionData(cookie_header_value,user_agent,organization_id)ProxiesNOTE ( Only proxies with no user/passwd authentication are supported )How to set HTTP/S proxiesIf you'd like to set an HTTP proxy for all requests, follow this example:fromclaude2_api.clientimportHTTPProxy,ClaudeAPIClientfromclaude2_api.sessionimportSessionData# Create HTTPProxy instancehttp_proxy=HTTPProxy("the.proxy.ip.addr",# Proxy IP8080,# Proxy portuse_ssl=False# Set to True if proxy uses HTTPS schema)session=SessionData(...)# Give the proxy instance to ClaudeAPIClient constructor, along with session data.client=ClaudeAPIClient(session,proxy=http_proxy)How to set SOCKS proxiesIf you want to opt for SOCKS proxies instead, the procedure is the same, but you need to import theSOCKSProxyclass instead, configuring it with the version number.fromclaude2_api.clientimportSOCKSProxy,ClaudeAPIClientfromclaude2_api.sessionimportSessionData# Create SOCKSProxy instancesocks_proxy=SOCKSProxy("the.proxy.ip.addr",# Proxy IP8080,# Proxy portversion_num=5# Either 4 or 5, defaults to 4)session=SessionData(...)# Give the proxy instance to ClaudeAPIClient constructor as usualclient=ClaudeAPIClient(session,proxy=socks_proxy)Changing Claude modelIn case you have accounts that are unable to migrate to newer models, you can override themodel_namestring parameter ofClaudeAPIClientconstructor.fromclaude2_api.clientimportClaudeAPIClientfromclaude2_api.sessionimportSessionDatasession=SessionData(...)# Defaults to claude-2.1client=ClaudeAPIClient(session,model_name="claude-2.0")TROUBLESHOOTINGSome common errors that may arise during the usage of this API:Error [400](Unable to prepare file attachment):To fix this error, change the extension of the attachment file to something like .txt, since by default this api will fallback to octet-stream for unknown file extensions, Claude may reject the file data.Error [403]:*This bug should be already fixed after version 0.2.2*This api will sometime return a 403 status_code when callingsend_message, when this happens it is recommeded to look for these things:Check if your IP location is allowed, should be in US/UK, other locations may work sporadically.Don't try to send the same prompt/file over and over again, instead wait for some time, and change input.DISCLAIMERThis repository provides an unofficial API for automating free accounts onclaude.ai.
Please note that this API is not endorsed, supported, or maintained by Anthropic. Use it at your own discretion and risk. Anthropic may make changes to their official product or APIs at any time, which could affect the functionality of this unofficial API. We do not guarantee the accuracy, reliability, or security of the information and data retrieved using this API. By using this repository, you agree that the maintainers are not responsible for any damages, issues, or consequences that may arise from its usage. Always refer to Anthropic's official documentation and terms of use. This project is maintained independently by contributors who are not affiliated with Anthropic.DONATINGA huge thank you in advance to anyone who wants to donate :)