From 9dc03ce5b5ad7ce259250d965cc985760802f060 Mon Sep 17 00:00:00 2001
From: Florian Maas <fpgmaas@gmail.com>
Date: Sat, 22 Jun 2024 12:25:40 +0200
Subject: [PATCH] add github and kofi badges, add rate limiter

---
 frontend/app/components/GitHubButton.tsx      |  25 +++
 .../app/components/SearchResultsTable.tsx     |  10 +-
 frontend/app/components/SupportButton.tsx     |  23 +++
 frontend/app/page.tsx                         |  21 ++-
 frontend/app/utils/search.ts                  |  11 +-
 frontend/public/kofi.png                      | Bin 0 -> 35716 bytes
 poetry.lock                                   | 144 +++++++++++++++++-
 pypi_scout/api/main.py                        |  32 +++-
 pypi_scout/config.py                          |   4 +-
 pypi_scout/vector_database/interface.py       |   1 +
 pyproject.toml                                |   1 +
 11 files changed, 251 insertions(+), 21 deletions(-)
 create mode 100644 frontend/app/components/GitHubButton.tsx
 create mode 100644 frontend/app/components/SupportButton.tsx
 create mode 100644 frontend/public/kofi.png

diff --git a/frontend/app/components/GitHubButton.tsx b/frontend/app/components/GitHubButton.tsx
new file mode 100644
index 0000000..8104cc5
--- /dev/null
+++ b/frontend/app/components/GitHubButton.tsx
@@ -0,0 +1,25 @@
+import React from "react";
+
+const GitHubButton: React.FC = () => {
+  return (
+    <a
+      href="https://github.com/fpgmaas/pypi-scout"
+      target="_blank"
+      rel="noopener noreferrer"
+      className="flex items-center p-2 border border-gray-700 rounded bg-gray-900 text-white hover:bg-gray-700 focus:outline-none focus:ring-2 focus:ring-gray-700"
+    >
+      <svg
+        height="24"
+        width="24"
+        viewBox="0 0 16 16"
+        fill="white"
+        className="mr-2"
+      >
+        <path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.58.82-2.14-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.14 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.45.55.38A8.001 8.001 0 0 0 16 8c0-4.42-3.58-8-8-8z" />
+      </svg>
+      GitHub
+    </a>
+  );
+};
+
+export default GitHubButton;
diff --git a/frontend/app/components/SearchResultsTable.tsx b/frontend/app/components/SearchResultsTable.tsx
index 4e866c3..befefa5 100644
--- a/frontend/app/components/SearchResultsTable.tsx
+++ b/frontend/app/components/SearchResultsTable.tsx
@@ -25,6 +25,12 @@ const SearchResultsTable: React.FC<SearchResultsTableProps> = ({
     return sortField === field ? (sortDirection === "asc" ? "▲" : "▼") : "";
   };
 
+  const truncateText = (text: string, maxLength: number) => {
+    return text.length > maxLength
+      ? `${text.substring(0, maxLength)}...`
+      : text;
+  };
+
   return (
     <div className="overflow-x-auto w-full">
       <table className="min-w-full divide-y divide-gray-700">
@@ -70,7 +76,7 @@ const SearchResultsTable: React.FC<SearchResultsTableProps> = ({
           {results.map((result, index) => (
             <tr key={index} className="hover:bg-gray-700">
               <td className="px-4 py-2 whitespace-nowrap text-gray-200">
-                {result.name}
+                {truncateText(result.name, 20)}
               </td>
               <td className="px-4 py-2 whitespace-nowrap text-gray-200">
                 {result.similarity.toFixed(3)}
@@ -78,7 +84,7 @@ const SearchResultsTable: React.FC<SearchResultsTableProps> = ({
               <td className="px-4 py-2 whitespace-nowrap text-gray-200">
                 {result.weekly_downloads.toLocaleString()}
               </td>
-              <td className="px-4 py-2 whitespace-normal break-words text-gray-200">
+              <td className="px-4 py-2 whitespace-normal break-words text-gray-200 min-w-[400px]">
                 {result.summary}
               </td>
               <td className="px-4 py-2 whitespace-nowrap">
diff --git a/frontend/app/components/SupportButton.tsx b/frontend/app/components/SupportButton.tsx
new file mode 100644
index 0000000..a55a2fb
--- /dev/null
+++ b/frontend/app/components/SupportButton.tsx
@@ -0,0 +1,23 @@
+import React from "react";
+
+const SupportButton: React.FC = () => {
+  return (
+    <a
+      href="https://ko-fi.com/fpgmaas"
+      target="_blank"
+      rel="noopener noreferrer"
+      className="flex items-center p-2 border border-gray-700 rounded bg-gray-900 text-white hover:bg-gray-700 focus:outline-none focus:ring-2 focus:ring-gray-700"
+    >
+      <img
+        src="kofi.png"
+        alt="Ko-fi logo"
+        width="24"
+        height="24"
+        className="mr-2"
+      />
+      Support
+    </a>
+  );
+};
+
+export default SupportButton;
diff --git a/frontend/app/page.tsx b/frontend/app/page.tsx
index f9b603f..b539365 100644
--- a/frontend/app/page.tsx
+++ b/frontend/app/page.tsx
@@ -5,6 +5,8 @@ import { handleSearch, sortResults } from "./utils/search";
 import SearchResultsTable from "./components/SearchResultsTable";
 import InfoBox from "./components/InfoBox";
 import { ClipLoader } from "react-spinners";
+import GitHubButton from "./components/GitHubButton";
+import SupportButton from "./components/SupportButton";
 
 interface Match {
   name: string;
@@ -31,20 +33,29 @@ export default function Home() {
   };
 
   return (
-    <main className="flex flex-col items-center justify-start min-h-screen p-4 space-y-4 max-w-[2200px] mx-auto">
-      <header className="w-full flex flex-col items-center text-center mb-4">
+    <main className="flex flex-col items-center justify-start min-h-screen p-4 space-y-4 max-w-[2200px] mx-auto relative">
+      <header className="w-full flex justify-end p-4">
+        <div className="flex space-x-4">
+          <GitHubButton />
+          <SupportButton />
+        </div>
+      </header>
+
+      <div className="flex flex-col items-center text-center mb-4">
         <picture>
           <img
             alt="pypi-scout logo"
             width="420"
             height="220"
             src="./pypi.svg"
+            className="mx-auto"
           ></img>
         </picture>
         <p className="text-lg text-gray-300 mt-2">
           Enter your query to search for Python packages
         </p>
-      </header>
+      </div>
+
       <div className="flex flex-col items-center space-y-4 w-3/5 bg-gray-800 p-6 rounded-lg shadow-lg">
         <textarea
           className="w-full h-24 p-2 border border-gray-700 rounded resize-none overflow-auto focus:outline-none focus:ring-2 focus:ring-blue-700 bg-gray-700 text-white"
@@ -53,7 +64,7 @@ export default function Home() {
           placeholder="Enter your query here..."
         ></textarea>
         <button
-          className="w-[250px] p-2 border border-gray-700 rounded bg-blue-600 text-white hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-700"
+          className="w-full max-w-[250px] p-2 border border-gray-700 rounded bg-blue-600 text-white hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-700"
           onClick={() =>
             handleSearch(
               text,
@@ -75,7 +86,7 @@ export default function Home() {
 
       <div className="w-full flex justify-center mt-6">
         <button
-          className="w-[250px] p-2 border border-gray-700 rounded bg-gray-600 text-white hover:bg-gray-700 focus:outline-none focus:ring-2 focus:ring-gray-700"
+          className="w-full max-w-[250px] p-2 border border-gray-700 rounded bg-gray-600 text-white hover:bg-gray-700 focus:outline-none focus:ring-2 focus:ring-gray-700"
           onClick={() => setInfoBoxVisible(!infoBoxVisible)}
         >
           {infoBoxVisible ? "Hide Info" : "How does this work?"}
diff --git a/frontend/app/utils/search.ts b/frontend/app/utils/search.ts
index 57f70cd..b457cf7 100644
--- a/frontend/app/utils/search.ts
+++ b/frontend/app/utils/search.ts
@@ -34,7 +34,11 @@ export const handleSearch = async (
     const fetchedResults: Match[] = response.data.matches;
     setResults(sortResults(fetchedResults, sortField, sortDirection));
   } catch (error) {
-    setError("Error fetching search results.");
+    if (axios.isAxiosError(error) && error.response?.status === 429) {
+      setError("Rate limit reached. Please wait a minute and try again.");
+    } else {
+      setError("Error fetching search results.");
+    }
     console.error("Error fetching search results:", error);
   } finally {
     setLoading(false);
@@ -48,8 +52,9 @@ export const sortResults = (
 ): Match[] => {
   return [...data].sort((a, b) => {
     // @ts-ignore
-    if (a[field] < b[field]) return direction === "asc" ? -1 : 1; // @ts-ignore
-    if (a[field] > b[field]) return direction === "asc" ? 1 : -1; // @ts-ignore
+    if (a[field] < b[field]) return direction === "asc" ? -1 : 1;
+    // @ts-ignore
+    if (a[field] > b[field]) return direction === "asc" ? 1 : -1;
     return 0;
   });
 };
diff --git a/frontend/public/kofi.png b/frontend/public/kofi.png
new file mode 100644
index 0000000000000000000000000000000000000000..7f6b47b6dab6e2735b773216341da8e0a9863cf1
GIT binary patch
literal 35716
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
HI2`{!IO{q&

literal 0
HcmV?d00001

diff --git a/poetry.lock b/poetry.lock
index 110e780..3875e38 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -718,6 +718,23 @@ files = [
     {file = "defusedxml-0.7.1.tar.gz", hash = "sha256:1bb3032db185915b62d7c6209c5a8792be6a32ab2fedacc84e01b52c51aa3e69"},
 ]
 
+[[package]]
+name = "deprecated"
+version = "1.2.14"
+description = "Python @deprecated decorator to deprecate old python classes, functions or methods."
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+files = [
+    {file = "Deprecated-1.2.14-py2.py3-none-any.whl", hash = "sha256:6fac8b097794a90302bdbb17b9b815e732d3c4720583ff1b198499d78470466c"},
+    {file = "Deprecated-1.2.14.tar.gz", hash = "sha256:e5323eb936458dccc2582dc6f9c322c852a775a27065ff2b0c4970b9d53d01b3"},
+]
+
+[package.dependencies]
+wrapt = ">=1.10,<2"
+
+[package.extras]
+dev = ["PyTest", "PyTest-Cov", "bump2version (<1)", "sphinx (<2)", "tox"]
+
 [[package]]
 name = "deptry"
 version = "0.12.0"
@@ -1637,6 +1654,35 @@ docs = ["autodoc-traits", "jinja2 (<3.2.0)", "mistune (<4)", "myst-parser", "pyd
 openapi = ["openapi-core (>=0.18.0,<0.19.0)", "ruamel-yaml"]
 test = ["hatch", "ipykernel", "openapi-core (>=0.18.0,<0.19.0)", "openapi-spec-validator (>=0.6.0,<0.8.0)", "pytest (>=7.0,<8)", "pytest-console-scripts", "pytest-cov", "pytest-jupyter[server] (>=0.6.2)", "pytest-timeout", "requests-mock", "ruamel-yaml", "sphinxcontrib-spelling", "strict-rfc3339", "werkzeug"]
 
+[[package]]
+name = "limits"
+version = "3.12.0"
+description = "Rate limiting utilities"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "limits-3.12.0-py3-none-any.whl", hash = "sha256:48d91e94a0888fb1251aa31423d716ae72ceff997231363f7968a5eaa51dc56d"},
+    {file = "limits-3.12.0.tar.gz", hash = "sha256:95764065715a11b9fdcc82558cac2fb59a1febbb7aa2acd045f72ab0c16ec04f"},
+]
+
+[package.dependencies]
+deprecated = ">=1.2"
+importlib-resources = ">=1.3"
+packaging = ">=21,<25"
+typing-extensions = "*"
+
+[package.extras]
+all = ["aetcd", "coredis (>=3.4.0,<5)", "emcache (>=0.6.1)", "emcache (>=1)", "etcd3", "motor (>=3,<4)", "pymemcache (>3,<5.0.0)", "pymongo (>4.1,<5)", "redis (>3,!=4.5.2,!=4.5.3,<6.0.0)", "redis (>=4.2.0,!=4.5.2,!=4.5.3)"]
+async-etcd = ["aetcd"]
+async-memcached = ["emcache (>=0.6.1)", "emcache (>=1)"]
+async-mongodb = ["motor (>=3,<4)"]
+async-redis = ["coredis (>=3.4.0,<5)"]
+etcd = ["etcd3"]
+memcached = ["pymemcache (>3,<5.0.0)"]
+mongodb = ["pymongo (>4.1,<5)"]
+redis = ["redis (>3,!=4.5.2,!=4.5.3,<6.0.0)"]
+rediscluster = ["redis (>=4.2.0,!=4.5.2,!=4.5.3)"]
+
 [[package]]
 name = "lxml"
 version = "5.2.2"
@@ -3968,6 +4014,23 @@ files = [
     {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"},
 ]
 
+[[package]]
+name = "slowapi"
+version = "0.1.9"
+description = "A rate limiting extension for Starlette and Fastapi"
+optional = false
+python-versions = ">=3.7,<4.0"
+files = [
+    {file = "slowapi-0.1.9-py3-none-any.whl", hash = "sha256:cfad116cfb84ad9d763ee155c1e5c5cbf00b0d47399a769b227865f5df576e36"},
+    {file = "slowapi-0.1.9.tar.gz", hash = "sha256:639192d0f1ca01b1c6d95bf6c71d794c3a9ee189855337b4821f7f457dddad77"},
+]
+
+[package.dependencies]
+limits = ">=2.3"
+
+[package.extras]
+redis = ["redis (>=3.4.1,<4.0.0)"]
+
 [[package]]
 name = "sniffio"
 version = "1.3.1"
@@ -4983,6 +5046,85 @@ files = [
 [package.extras]
 test = ["pytest (>=6.0.0)", "setuptools (>=65)"]
 
+[[package]]
+name = "wrapt"
+version = "1.16.0"
+description = "Module for decorators, wrappers and monkey patching."
+optional = false
+python-versions = ">=3.6"
+files = [
+    {file = "wrapt-1.16.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:ffa565331890b90056c01db69c0fe634a776f8019c143a5ae265f9c6bc4bd6d4"},
+    {file = "wrapt-1.16.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e4fdb9275308292e880dcbeb12546df7f3e0f96c6b41197e0cf37d2826359020"},
+    {file = "wrapt-1.16.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bb2dee3874a500de01c93d5c71415fcaef1d858370d405824783e7a8ef5db440"},
+    {file = "wrapt-1.16.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2a88e6010048489cda82b1326889ec075a8c856c2e6a256072b28eaee3ccf487"},
+    {file = "wrapt-1.16.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ac83a914ebaf589b69f7d0a1277602ff494e21f4c2f743313414378f8f50a4cf"},
+    {file = "wrapt-1.16.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:73aa7d98215d39b8455f103de64391cb79dfcad601701a3aa0dddacf74911d72"},
+    {file = "wrapt-1.16.0-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:807cc8543a477ab7422f1120a217054f958a66ef7314f76dd9e77d3f02cdccd0"},
+    {file = "wrapt-1.16.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:bf5703fdeb350e36885f2875d853ce13172ae281c56e509f4e6eca049bdfb136"},
+    {file = "wrapt-1.16.0-cp310-cp310-win32.whl", hash = "sha256:f6b2d0c6703c988d334f297aa5df18c45e97b0af3679bb75059e0e0bd8b1069d"},
+    {file = "wrapt-1.16.0-cp310-cp310-win_amd64.whl", hash = "sha256:decbfa2f618fa8ed81c95ee18a387ff973143c656ef800c9f24fb7e9c16054e2"},
+    {file = "wrapt-1.16.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1a5db485fe2de4403f13fafdc231b0dbae5eca4359232d2efc79025527375b09"},
+    {file = "wrapt-1.16.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:75ea7d0ee2a15733684badb16de6794894ed9c55aa5e9903260922f0482e687d"},
+    {file = "wrapt-1.16.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a452f9ca3e3267cd4d0fcf2edd0d035b1934ac2bd7e0e57ac91ad6b95c0c6389"},
+    {file = "wrapt-1.16.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:43aa59eadec7890d9958748db829df269f0368521ba6dc68cc172d5d03ed8060"},
+    {file = "wrapt-1.16.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:72554a23c78a8e7aa02abbd699d129eead8b147a23c56e08d08dfc29cfdddca1"},
+    {file = "wrapt-1.16.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:d2efee35b4b0a347e0d99d28e884dfd82797852d62fcd7ebdeee26f3ceb72cf3"},
+    {file = "wrapt-1.16.0-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:6dcfcffe73710be01d90cae08c3e548d90932d37b39ef83969ae135d36ef3956"},
+    {file = "wrapt-1.16.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:eb6e651000a19c96f452c85132811d25e9264d836951022d6e81df2fff38337d"},
+    {file = "wrapt-1.16.0-cp311-cp311-win32.whl", hash = "sha256:66027d667efe95cc4fa945af59f92c5a02c6f5bb6012bff9e60542c74c75c362"},
+    {file = "wrapt-1.16.0-cp311-cp311-win_amd64.whl", hash = "sha256:aefbc4cb0a54f91af643660a0a150ce2c090d3652cf4052a5397fb2de549cd89"},
+    {file = "wrapt-1.16.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:5eb404d89131ec9b4f748fa5cfb5346802e5ee8836f57d516576e61f304f3b7b"},
+    {file = "wrapt-1.16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:9090c9e676d5236a6948330e83cb89969f433b1943a558968f659ead07cb3b36"},
+    {file = "wrapt-1.16.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:94265b00870aa407bd0cbcfd536f17ecde43b94fb8d228560a1e9d3041462d73"},
+    {file = "wrapt-1.16.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f2058f813d4f2b5e3a9eb2eb3faf8f1d99b81c3e51aeda4b168406443e8ba809"},
+    {file = "wrapt-1.16.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:98b5e1f498a8ca1858a1cdbffb023bfd954da4e3fa2c0cb5853d40014557248b"},
+    {file = "wrapt-1.16.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:14d7dc606219cdd7405133c713f2c218d4252f2a469003f8c46bb92d5d095d81"},
+    {file = "wrapt-1.16.0-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:49aac49dc4782cb04f58986e81ea0b4768e4ff197b57324dcbd7699c5dfb40b9"},
+    {file = "wrapt-1.16.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:418abb18146475c310d7a6dc71143d6f7adec5b004ac9ce08dc7a34e2babdc5c"},
+    {file = "wrapt-1.16.0-cp312-cp312-win32.whl", hash = "sha256:685f568fa5e627e93f3b52fda002c7ed2fa1800b50ce51f6ed1d572d8ab3e7fc"},
+    {file = "wrapt-1.16.0-cp312-cp312-win_amd64.whl", hash = "sha256:dcdba5c86e368442528f7060039eda390cc4091bfd1dca41e8046af7c910dda8"},
+    {file = "wrapt-1.16.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:d462f28826f4657968ae51d2181a074dfe03c200d6131690b7d65d55b0f360f8"},
+    {file = "wrapt-1.16.0-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a33a747400b94b6d6b8a165e4480264a64a78c8a4c734b62136062e9a248dd39"},
+    {file = "wrapt-1.16.0-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b3646eefa23daeba62643a58aac816945cadc0afaf21800a1421eeba5f6cfb9c"},
+    {file = "wrapt-1.16.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3ebf019be5c09d400cf7b024aa52b1f3aeebeff51550d007e92c3c1c4afc2a40"},
+    {file = "wrapt-1.16.0-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:0d2691979e93d06a95a26257adb7bfd0c93818e89b1406f5a28f36e0d8c1e1fc"},
+    {file = "wrapt-1.16.0-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:1acd723ee2a8826f3d53910255643e33673e1d11db84ce5880675954183ec47e"},
+    {file = "wrapt-1.16.0-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:bc57efac2da352a51cc4658878a68d2b1b67dbe9d33c36cb826ca449d80a8465"},
+    {file = "wrapt-1.16.0-cp36-cp36m-win32.whl", hash = "sha256:da4813f751142436b075ed7aa012a8778aa43a99f7b36afe9b742d3ed8bdc95e"},
+    {file = "wrapt-1.16.0-cp36-cp36m-win_amd64.whl", hash = "sha256:6f6eac2360f2d543cc875a0e5efd413b6cbd483cb3ad7ebf888884a6e0d2e966"},
+    {file = "wrapt-1.16.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:a0ea261ce52b5952bf669684a251a66df239ec6d441ccb59ec7afa882265d593"},
+    {file = "wrapt-1.16.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7bd2d7ff69a2cac767fbf7a2b206add2e9a210e57947dd7ce03e25d03d2de292"},
+    {file = "wrapt-1.16.0-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9159485323798c8dc530a224bd3ffcf76659319ccc7bbd52e01e73bd0241a0c5"},
+    {file = "wrapt-1.16.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a86373cf37cd7764f2201b76496aba58a52e76dedfaa698ef9e9688bfd9e41cf"},
+    {file = "wrapt-1.16.0-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:73870c364c11f03ed072dda68ff7aea6d2a3a5c3fe250d917a429c7432e15228"},
+    {file = "wrapt-1.16.0-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:b935ae30c6e7400022b50f8d359c03ed233d45b725cfdd299462f41ee5ffba6f"},
+    {file = "wrapt-1.16.0-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:db98ad84a55eb09b3c32a96c576476777e87c520a34e2519d3e59c44710c002c"},
+    {file = "wrapt-1.16.0-cp37-cp37m-win32.whl", hash = "sha256:9153ed35fc5e4fa3b2fe97bddaa7cbec0ed22412b85bcdaf54aeba92ea37428c"},
+    {file = "wrapt-1.16.0-cp37-cp37m-win_amd64.whl", hash = "sha256:66dfbaa7cfa3eb707bbfcd46dab2bc6207b005cbc9caa2199bcbc81d95071a00"},
+    {file = "wrapt-1.16.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:1dd50a2696ff89f57bd8847647a1c363b687d3d796dc30d4dd4a9d1689a706f0"},
+    {file = "wrapt-1.16.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:44a2754372e32ab315734c6c73b24351d06e77ffff6ae27d2ecf14cf3d229202"},
+    {file = "wrapt-1.16.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e9723528b9f787dc59168369e42ae1c3b0d3fadb2f1a71de14531d321ee05b0"},
+    {file = "wrapt-1.16.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:dbed418ba5c3dce92619656802cc5355cb679e58d0d89b50f116e4a9d5a9603e"},
+    {file = "wrapt-1.16.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:941988b89b4fd6b41c3f0bfb20e92bd23746579736b7343283297c4c8cbae68f"},
+    {file = "wrapt-1.16.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:6a42cd0cfa8ffc1915aef79cb4284f6383d8a3e9dcca70c445dcfdd639d51267"},
+    {file = "wrapt-1.16.0-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:1ca9b6085e4f866bd584fb135a041bfc32cab916e69f714a7d1d397f8c4891ca"},
+    {file = "wrapt-1.16.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:d5e49454f19ef621089e204f862388d29e6e8d8b162efce05208913dde5b9ad6"},
+    {file = "wrapt-1.16.0-cp38-cp38-win32.whl", hash = "sha256:c31f72b1b6624c9d863fc095da460802f43a7c6868c5dda140f51da24fd47d7b"},
+    {file = "wrapt-1.16.0-cp38-cp38-win_amd64.whl", hash = "sha256:490b0ee15c1a55be9c1bd8609b8cecd60e325f0575fc98f50058eae366e01f41"},
+    {file = "wrapt-1.16.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:9b201ae332c3637a42f02d1045e1d0cccfdc41f1f2f801dafbaa7e9b4797bfc2"},
+    {file = "wrapt-1.16.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:2076fad65c6736184e77d7d4729b63a6d1ae0b70da4868adeec40989858eb3fb"},
+    {file = "wrapt-1.16.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c5cd603b575ebceca7da5a3a251e69561bec509e0b46e4993e1cac402b7247b8"},
+    {file = "wrapt-1.16.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b47cfad9e9bbbed2339081f4e346c93ecd7ab504299403320bf85f7f85c7d46c"},
+    {file = "wrapt-1.16.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f8212564d49c50eb4565e502814f694e240c55551a5f1bc841d4fcaabb0a9b8a"},
+    {file = "wrapt-1.16.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:5f15814a33e42b04e3de432e573aa557f9f0f56458745c2074952f564c50e664"},
+    {file = "wrapt-1.16.0-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:db2e408d983b0e61e238cf579c09ef7020560441906ca990fe8412153e3b291f"},
+    {file = "wrapt-1.16.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:edfad1d29c73f9b863ebe7082ae9321374ccb10879eeabc84ba3b69f2579d537"},
+    {file = "wrapt-1.16.0-cp39-cp39-win32.whl", hash = "sha256:ed867c42c268f876097248e05b6117a65bcd1e63b779e916fe2e33cd6fd0d3c3"},
+    {file = "wrapt-1.16.0-cp39-cp39-win_amd64.whl", hash = "sha256:eb1b046be06b0fce7249f1d025cd359b4b80fc1c3e24ad9eca33e0dcdb2e4a35"},
+    {file = "wrapt-1.16.0-py3-none-any.whl", hash = "sha256:6906c4100a8fcbf2fa735f6059214bb13b97f75b1a61777fcf6432121ef12ef1"},
+    {file = "wrapt-1.16.0.tar.gz", hash = "sha256:5f370f952971e7d17c7d1ead40e49f32345a7f7a5373571ef44d800d06b1899d"},
+]
+
 [[package]]
 name = "zipp"
 version = "3.19.2"
@@ -5001,4 +5143,4 @@ test = ["big-O", "importlib-resources", "jaraco.functools", "jaraco.itertools",
 [metadata]
 lock-version = "2.0"
 python-versions = ">=3.8,<4.0"
-content-hash = "35d15e157357093f2ed35f9cae6ce7e9cb78f2d8592161a4939141ae437bd84a"
+content-hash = "843fe913424c319e3c9917be384c66b65fbb936702296f9ae0b626ac604a23f3"
diff --git a/pypi_scout/api/main.py b/pypi_scout/api/main.py
index 82e22a7..bf03118 100644
--- a/pypi_scout/api/main.py
+++ b/pypi_scout/api/main.py
@@ -1,10 +1,15 @@
 import logging
 
+import polars as pl
 from dotenv import load_dotenv
 from fastapi import FastAPI, HTTPException
 from fastapi.middleware.cors import CORSMiddleware
 from pydantic import BaseModel
 from sentence_transformers import SentenceTransformer
+from slowapi import Limiter, _rate_limit_exceeded_handler
+from slowapi.errors import RateLimitExceeded
+from slowapi.util import get_remote_address
+from starlette.requests import Request
 
 from pypi_scout.api.utils import load_dataset
 from pypi_scout.config import Config
@@ -15,7 +20,10 @@
 setup_logging()
 logging.info("Initializing backend...")
 
+limiter = Limiter(key_func=get_remote_address)
 app = FastAPI()
+app.state.limiter = limiter
+app.add_exception_handler(RateLimitExceeded, _rate_limit_exceeded_handler)
 
 load_dotenv()
 config = Config()
@@ -56,21 +64,29 @@ class SearchResponse(BaseModel):
     matches: list[Match]
 
 
-@app.post("/api/search/", response_model=SearchResponse)
-async def search(query: QueryModel):
+@app.post("/api/search", response_model=SearchResponse)
+@limiter.limit("4/minute")
+async def search(query: QueryModel, request: Request):
     """
     Search for the packages whose summary and description have the highest similarity to the query.
     We take the top_k * 2 most similar packages, and then calculate weighted score based on the similarity and weekly downloads.
     The top_k packages with the highest score are returned.
     """
 
+    if query.top_k > 100:
+        raise HTTPException(status_code=400, detail="top_k cannot be larger than 100.")
+
     logging.info(f"Searching for similar projects. Query: '{query.query}'")
     df_matches = vector_database_interface.find_similar(query.query, top_k=query.top_k * 2)
     df_matches = df_matches.join(df, how="left", on="name")
+    logging.info(
+        f"Fetched the {len(df_matches)} most similar projects. Calculating the weighted scores and filtering..."
+    )
 
-    if df_matches["weekly_downloads"].is_null().any():
+    matches_missing_in_local_dataset = df_matches.filter(pl.col("weekly_downloads").is_null())["name"].to_list()
+    if matches_missing_in_local_dataset:
         logging.error(
-            "One or more entries have 'None' for 'weekly_downloads'. "
+            f"The following entries have 'None' for 'weekly_downloads': {matches_missing_in_local_dataset} "
             "This means they were found in the vector database but not in the local dataset."
         )
         logging.error(
@@ -78,11 +94,11 @@ async def search(query: QueryModel):
             "value than the vector database."
         )
         logging.error("To solve this, delete the Pinecone index and rerun the setup script.")
-        raise HTTPException(status_code=400, detail="One or more entries have 'None' for 'weekly_downloads'.")
+        raise HTTPException(
+            status_code=400,
+            detail=f"The packages {matches_missing_in_local_dataset} are available in Pinecone but not in the local dataset.",
+        )
 
-    logging.info(
-        f"Fetched the {len(df_matches)} most similar projects. Calculating the weighted scores and filtering..."
-    )
     df_matches = calculate_score(
         df_matches, weight_similarity=config.WEIGHT_SIMILARITY, weight_weekly_downloads=config.WEIGHT_WEEKLY_DOWNLOADS
     )
diff --git a/pypi_scout/config.py b/pypi_scout/config.py
index ee19d89..1f3f8d0 100644
--- a/pypi_scout/config.py
+++ b/pypi_scout/config.py
@@ -53,8 +53,8 @@ class Config:
     # Weights for the combined score calculation. Higher WEIGHT_SIMILARITY prioritizes
     # relevance based on text similarity, while higher WEIGHT_WEEKLY_DOWNLOADS prioritizes
     # packages with more weekly downloads.
-    WEIGHT_SIMILARITY = 0.8
-    WEIGHT_WEEKLY_DOWNLOADS = 0.2
+    WEIGHT_SIMILARITY = 0.6
+    WEIGHT_WEEKLY_DOWNLOADS = 0.4
 
     # Storage backend configuration. Can be either StorageBackend.LOCAL or StorageBackend.BLOB.
     # If StorageBackend.BLOB, the processed dataset will be uploaded to Blob, and the backend API
diff --git a/pypi_scout/vector_database/interface.py b/pypi_scout/vector_database/interface.py
index fbadff1..3293231 100644
--- a/pypi_scout/vector_database/interface.py
+++ b/pypi_scout/vector_database/interface.py
@@ -32,6 +32,7 @@ def __init__(
         pc = Pinecone(api_key=pinecone_token)
         self.index = pc.Index(pinecone_index_name)
         self.pinecone_namespace = pinecone_namespace
+        logging.info("Connection successful.")
 
     def upsert_polars(self, df: pl.DataFrame, key_column: str, text_column: str):
         """
diff --git a/pyproject.toml b/pyproject.toml
index 24d29fa..6ffa08d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -24,6 +24,7 @@ pydantic = "^2.7.4"
 uvicorn = "^0.30.1"
 gdown = "^5.2.0"
 azure-storage-blob = "^12.20.0"
+slowapi = "^0.1.9"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.2.0"