MCPcopy Index your code
hub / github.com/ai-hermes/doc-solver

github.com/ai-hermes/doc-solver @v0.1.29

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.1.29 ↗ · + Follow
481 symbols 1,214 edges 196 files 11 documented · 2%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

DocSolver - Create a ChatGPT Chatbot for Your PDF Files

Use the new GPT-4 api to build a chatGPT chatbot for multiple Large PDF files.

Tech stack used includes LangChain, Pinecone, Typescript, Openai, and Next.js. LangChain is a framework that makes it easier to build scalable AI/LLM apps and chatbots. Pinecone is a vectorstore for storing embeddings and your PDF in text to later retrieve similar docs.

preview in https://docsolver.spotty.com.cn/

Development

  1. Clone the repo or download the ZIP
git clone https://github.com/ai-hermes/doc-solver.git
  1. Install packages

First ensure your node version >= 18.

and run npm install yarn -g to install yarn globally (if you haven't already).

Then run:

yarn install

After installation, you should now see a node_modules folder.

  1. Set up your .env file

  2. Copy .env.example into .env Your .env file should look like this:

OPENAI_API_KEY=

PINECONE_API_KEY=
PINECONE_ENVIRONMENT=

PINECONE_INDEX_NAME=

  • Visit openai to retrieve API keys and insert into your .env file.
  • Visit pinecone to create and retrieve your API keys, and also retrieve your environment and index name from the dashboard.

  • In the config folder, replace the PINECONE_NAME_SPACE with a namespace where you'd like to store your embeddings on Pinecone when you run npm run ingest. This namespace will later be used for queries and retrieval.

  • In utils/makechain.ts chain change the QA_PROMPT for your own usecase. Change modelName in new OpenAI to gpt-4, if you have access to gpt-4 api. Please verify outside this repo that you have access to gpt-4 api, otherwise the application will not work.

Convert your PDF files to embeddings

This repo can load multiple PDF files

  1. Inside docs folder, add your pdf files or folders that contain pdf files.
  2. Run the script yarn run ingest to 'ingest' and embed your docs. If you run into errors troubleshoot below.
  3. Check Pinecone dashboard to verify your namespace and vectors have been added.

Run the app

Once you've verified that the embeddings and content have been successfully added to your Pinecone, you can run the app npm run dev to launch the local dev environment, and then type a question in the chat interface.

Troubleshooting

In general, keep an eye out in the issues and discussions section of this repo for solutions.

General errors

  • Make sure you're running the latest Node version. Run node -v
  • Try a different PDF or convert your PDF to text first. It's possible your PDF is corrupted, scanned, or requires OCR to convert to text.
  • Console.log the env variables and make sure they are exposed.
  • Make sure you're using the same versions of LangChain and Pinecone as this repo.
  • Check that you've created an .env file that contains your valid (and working) API keys, environment and index name.
  • If you change modelName in OpenAI, make sure you have access to the api for the appropriate model.
  • Make sure you have enough OpenAI credits and a valid card on your billings account.
  • Check that you don't have multiple OPENAPI keys in your global environment. If you do, the local env file from the project will be overwritten by systems env variable.
  • Try to hard code your API keys into the process.env variables if there are still issues.

Pinecone errors

  • Make sure your pinecone dashboard environment and index matches the one in the pinecone.ts and .env files.
  • Check that you've set the vector dimensions to 1536.
  • Make sure your pinecone namespace is in lowercase.
  • Pinecone indexes of users on the Starter(free) plan are deleted after 7 days of inactivity. To prevent this, send an API request to Pinecone to reset the counter before 7 days.
  • Retry from scratch with a new Pinecone project, index, and cloned repo.

Credit

Frontend of this repo is inspired by - langchain-chat-nextjs - langchain-chat-nextjs - langchain-chat-nextjs - langchain-chat-nextjs - langchain-chat-nextjs

Contributors ♥️

License

Licensed under the MIT License, Copyright © 2021-present doc-solver

Extension points exported contracts — how you extend this code

Session (Interface)
* Returned by `useSession`, `getSession`, and received as a prop on the `SessionProvider` React Context
typings.d.ts
ProcessEnv (Interface)
(no doc)
env.d.ts
Job (Interface)
(no doc)
types/job.ts
Document (Interface)
(no doc)
types/document.ts
Highlight (Interface)
(no doc)
types/chat.ts
LayoutProps (Interface)
(no doc)
components/layout.tsx
BillingInfoProps (Interface)
(no doc)
components/billing-info.tsx
MobileNavProps (Interface)
(no doc)
components/layout/mobile-nav.tsx

Core symbols most depended-on inside this repo

cn
called by 155
utils/cn.ts
getPrismaClient
called by 13
lib/clients/prisma.ts
toast
called by 11
components/ui/use-toast.ts
isHTMLElement
called by 9
components/ui/react-pdf-highlighter/lib/pdfjs-dom.ts
asElement
called by 9
components/ui/react-pdf-highlighter/lib/pdfjs-dom.ts
add
called by 8
utils/typewriter.ts
renderHighlightLayers
called by 7
components/ui/react-pdf-highlighter/components/PdfHighlighter.tsx
checkLogin
called by 7
pages/api/user.ts

Shape

Function 249
Interface 116
Method 80
Class 36

Languages

TypeScript100%

Modules by API surface

components/ui/react-pdf-highlighter/components/PdfHighlighter.tsx20 symbols
components/ui/pdf/index.tsx16 symbols
components/ui/types.ts14 symbols
components/ui/react-pdf-highlighter/types.ts14 symbols
components/ui/react-pdf-highlighter/components/MouseSelection.tsx12 symbols
components/ui/react-pdf-highlighter/components/PdfLoader.tsx11 symbols
utils/chatWithRedisMemory.ts10 symbols
components/ui/stepper/index.tsx10 symbols
utils/typewriter.ts9 symbols
components/ui/use-toast.ts9 symbols
utils/pdfLoader.ts8 symbols
lib/pdfLoader.ts8 symbols

Datastores touched

(mysql)Database · 1 repos
doc_solverDatabase · 1 repos

For agents

$ claude mcp add doc-solver \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page