Skip to content

Troubleshooting

Jump to bottom
Yiğit ERDOĞAN edited this page Jan 11, 2026 · 1 revision

🔧 Troubleshooting

This guide addresses common issues you might encounter while installing or using CodeScope.

Common Issues

1. Ollama Connection Failed

Symptom: "Ollama is not connected" or "Model not found" errors in the UI. Solution:

  • Ensure Ollama is running (ollama serve or check system tray).
  • Verify you have pulled the model (ollama pull llama3).
  • Check OLLAMA_BASE_URL in your .env file.
  • If running in Docker, use host.docker.internal instead of localhost.

2. Ingestion Fails or Times Out

Symptom: Progress bar stops or an "Internal Server Error" occurs during ingestion. Solution:

  • Check if the path is an absolute path.
  • Ensure the backend has read permissions for the directory.
  • For very large repositories, try reducing MAX_FILES_TO_PROCESS in backend/app/core/config.py.
  • Check backend logs for specific Python errors.

3. Frontend Won't Load

Symptom: Blank page or "Connection Refused" at localhost:3000. Solution:

  • Ensure the frontend server is running (npm run dev).
  • Check if port 3000 is occupied by another process.
  • Verify NEXT_PUBLIC_API_URL is pointing to the correct backend address.

4. Poor AI Response Quality

Symptom: AI gives irrelevant or "I don't know" answers. Solution:

  • Re-ingest the repository to ensure the index is fresh.
  • Try a larger model (e.g., llama3.1) if your hardware allows.
  • Be more specific in your query.
  • Check if the files you are asking about have supported extensions.

5. High Resource Usage

Symptom: Computer slows down significantly during chat or ingestion. Solution:

  • Use a smaller model like phi or tinyllama.
  • Reduce CHUNK_SIZE in configuration.
  • Ensure you are not indexing unnecessary large folders like node_modules.

Getting More Help

If your issue isn't listed here:

  1. Check Logs: Look at the terminal output for both frontend and backend.
  2. Open an Issue: Visit the Issues page and provide as much detail as possible.
  3. Check FAQ: See the FAQ for general questions.

Next Steps

Clone this wiki locally