Skip to content

armgit / dspy

Public Imported from GitHub
0

DSPy: The framework for programming—not prompting—language models

Python

clear output in docs

Herumb Shandilyaa9a6aba7369a
diff --git a/examples/dataloaders/dataloaders_dolly.ipynb b/examples/dataloaders/dataloaders_dolly.ipynb
index 7612b58ff..fc86373f8 100644
--- a/examples/dataloaders/dataloaders_dolly.ipynb
+++ b/examples/dataloaders/dataloaders_dolly.ipynb
@@ -1,49 +1,35 @@
{
- "nbformat": 4,
- "nbformat_minor": 0,
- "metadata": {
- "colab": {
- "provenance": []
- },
- "kernelspec": {
- "name": "python3",
- "display_name": "Python 3"
- },
- "language_info": {
- "name": "python"
- }
- },
"cells": [
{
"cell_type": "markdown",
- "source": [
- "![dspy_logo.png](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAmEAAADECAYAAADXu/Y/AAAgAElEQVR4nO2dC5Qc1XnnL4aNnVhCnZxkDQJF44AkwEk0khDtPVk00wKDY42kwT4GjXhoiPUKmMPogXH2gGYkfE7A1ou1zQpJXkYYSUCWMKMHwTGoZyA5x40kNJO1JY2GxDMIBN4k6x5JzuKsvbPna+693L7TVX1vdVV1VfX/d04dqXv6UV1dXfWv7/H/LhgdHWUAAABCJcUYq3d4wzxjrA9fBwDJ5yJ8xwAA4Dt1fGlU/k/LZA9v1K8IM/q3hzE2xBcAQIxBJAwAACqHBFYzF120TAhhm45wYdajLACAGAERBpICpXa2xvCz6KknEe1gDCfVqEPCq42Lrum263r8xEl27tz5MfdPnHgpm3T5ZV4/ei9jrIvvO3FLaW51SdFGEfH7FL9hRCeBNRBhICnQiTCb0G+zVznQi4M9aoaqRytfGtzWIPfGEfbumTPszJn3WN+xNwv3fW/ndquVvvLKKayhMVP4f/2MmQWBdtnEiSx93bUmTx/mgmxrTMRBT7ltGhP6ld9qHMUwCBGIMJAUkizCnOhXDvI9uAoPlBQXXm1OdV0kug4fOVoQXLZiywtfvnURmzbtKjZj5gw2+9pZ5aJn/VyMdSmR1qiRFBGmM6Kki7vwOwUqEGEgKUgRRmmezZu3xOJjXXrpRPapSy6Rt+lkyrynpIa1g31UT7Zxg8RXRynxRcLrwIGD7Nm9u9lbbw1W9WPdfPOfsszcG9jMWTPZ527IOD1shO8bHREUA1KEPfbNTWxw8FT118iB8ePHsyuunFL447RpU9nF48ezq6+axi6+eLzJ0+MgiEFIQISBpCBFGJ0YP5uenYiPRSfWyydNYlOmTGWfHDeuINIsD/aduPr2TD3ffkX1XmfPnmMvdu9ne3c/w37wg7+J5IpTGnNRy+2sqWmeW+qym4uBqNQeShG2dNmKUKKJfiPSx5Q6JnGWnn2t2281yoIYhAREGEgKiRRhTpA4u/qaawpX4yTMDGqEhCDrxNW3EXRibFcfSOLr6Wf2sMe3bKp61MsG2leaFixkCxc0OUVXe/nnrbYYi70IKwWljWfNupbNnz+PXXP1VU4P2wUxVqOQCMOCJQFL4yjnR7nDdGVRc8tXli4f7Xx69+hPjp8YLUPn6OhoPfb7kkvd6Ohon775Xnixe/TKK6fEfp966OGOwu/DgR7++au17XvEatG+nMTf7803/+not7+7bfTt0+84fQf020zhd1g7S81vACyJWWpehOkH+0cf21hOkNFJrxm/AbmQMM2rG4hOlkkUBPSZXMRYtYRA4kWYurgIYtoH2/B7rI2l5jcAlsQsEGEOi8HV9xDE2GjrGCXy9O5ERL/cFhcx1lmF76CmRJhY6LM6XCz1ICqW/KVkTVg+k1bnmjVqf3abeWZCvaWbdG9IiWKRi/8EY+wS5X76//sOz4lKO/WwSy2BWuehGoP2pbK5JNUG1VRNmFe+snQ5u23RIqfuuajUBoUNdT8+Jd6Tar++tXEz+8YjHTWzAb793W3sq/esUO/6dBXqkxJZE2bKQw93sAfWrtYL+Uf4sQ1eYwmlSITlM+kOfkDyMt8MxJN+xWeqK8bCDCLMAirWXr5yJfti84JST9rF/bBqoYB/jABbumw5+6vnn63uWoXM26ffUYv2d/HtEjY1LcIY7658YtuTpS6S7uZNNSBhyAHe+Uy6Ve8GAjXBdL4soXb1fCbdmMrmcNWVcMhagRYHMbaEz0HsiOkoKFOKBBj5y3V0rA9EgFGH3MUXX1ywLhAITzgVMnsV/OL8+YJX1tmzZwMVhRSB0bomaycEGDGo6/amG+eWioqJ/RRCLGFcpHyctlrfGKCQJu7hKWdQAwgxRiJhzZo1qtUF7QtbuBhrTmBUrF4VYKffeZctXLDAN+uJtlVrCoJr9rUz3WwJxuBoNfLc3sI6nhw4xQYGThVc+Xt7sr6s7/LlS9Wbj8MmofpQKnxg4CTbuWM7hFjCUUWY9QBakEgm8GgYhkfXEBRpoaXEFXgDPyk3J6hWLKV+FkpBrlmztmJBQ/V2X5g3j904N2NqpmsFRatoUVNVFL07lO1lr/X2eIqWUS2YEgUbiWMUTJ2vGRTVSI3S93nszaOse98+VchDiCUMWROWz6THVuiDWuWWVDbXFbPP7rkm7Ee5w6YDkX2FIhs03JkQg55FCuqd06er5sbuUpeyPiGpqqIZhbfe1lJRuo/E17Jly8rtQyPKUGcRVezTIox601M9v6/OpE6X9icSZAcP7Df6PPQ9Hz16VBWM1f5+PdWE0fbfuePJoNdNQsL33Lnzhajk+++9V/i9BinS6HvShBhDjVhyKETC8pm0W7djv3agyFfQqeH1uXV8CQrqgLydMTbO4fV7tShA1CIC9Q4pRP2gnjKMeNbzcRogQERkww0SlCTQBk8NBn6wF7jUpbTz32Gci/bbVAH28DrvNWAlUrgqYiRNFz/mmab43H53jfy3Wc//XyTMaF9acufiwnK8o53t3fuca4fn/avWqN/tSMLr/3xDiCH1eycRKAa4e41KOkG/R0qVa0JsqyLqQYwpRMIo/SSiCDqpbO6CWviC3bYBXSGmsrlEFaty4T1mLh4njp83dpEwr9Dn6+npZUePHgm8i4+ERkdHu34V3s+3d9yEWB0/aRUscv66ax/70i0LPb1QCUsHQbcyrzNo6vj3QKnikh/EadRSBKNgzKdI2EgAwsQoEqlCUcnufQfYgX3dvkW06beo1YjF9XcIFC7CxqhNqAMyn0njxzuWTIiRTjWC2ajd5+hBR4JRiMbTmzYWUlCvv9YbSJRM1KVo6cnpfBvF7QSwVQgwOkk++MBa6xcg8fLM7j2lRHs1Zv8NKfNAU0oThRRkdMImsXjXHYuLxFiCo2B9Jbwt/SSl/EbrlWVMVJK2Oy0k9rdv21axGKPfInXYKoJzOt/n0FQXYz5W6xsAgCoi/Nl6+MG0g59E6SRyATfMzPAoRTc/WRYhUlB0YCavJ4rQkO2En4j0JJ1MFKbHrJO2URUnmzdvsS7EF7U5mgAb5t9Ra5W7CvNcjDXz/Wa9ur8IMUbRr86ndxdEmUKteML5QV54Kiq/1zq+ze/mv9MiyP7l5ZdfYi+82F3YhyqBLrS+80RR/dv9AYtOEDAQYR8BWwYQNYYUgdbM99EZjLFVpQ724upbHPApTeMnlLp77Jub1FeMkxCTqTZK527dssn90RoOxdG7eCQkajWiQ/zz1nFhMCz+QGKMRLsSBRtGgbcvDCki+Lf5du9XX5jEGIlgsi+phPvuXVloDlDA9xdjIMI+opJRTEkjyCYIUBl9PHXUzKNlt3AxUAQd8Ck6RvVufoqxrz+4tlDMrhAHIdaopnd37Nhh9WQHAbaKR7+iHEES0TEhxsZEUmHMGghiu9fzKKkcvUfid8vmjYWLpEogU2GFyVWacAB8ACLMjKSaFzqdQCDC4kMXPwCXvPqm1BmJsb995ZBvaUrquCshxKJcUyRPUBQFs62do3q4EvYAcauhEmJMTVMiChY8onaySATTRdJPjp/wnJ6k+rBd39+j3gUxHVMgwsxIqghDe3NycLz6JqiontKUVDPmByTEtBqxJRE9EaT4uhWwjYJR6kjzS1sfY+GS599RvTIfFISDEMHyd0nCniKsXoXYNzZ0FLpfOYiGxRSIMACSh7j6HiPGqGaMrsCp3b1SqEZME2LtPE0aJeSJiToibaJgdHJc31E0Trc7IRGHIb5d4AUYLnn+u5TlAyTEqNvWC9RYQh2vCoiGxRCIsI9wS8FhlhqII6oYk8XZdOB//rm97NHHNlb8kcjmoUSRcJTS2VKE7dlj56lWwsYBkQbgB62qEKOSAepY9cLjxQ0mkyN4EQTKIESYU1H6cA1tQCe3fPLUgggDcaaH/8aLCrke/Nqaitvm6Wp89arValpkQoTSdUUTIrKHXjV+Im0TzcahAzYOwEeKhBh1rHppoKHfnxaNxoVCzBAizKmzqZbEh5MQ/feQ1wOAIBD1QDPUiysqEK6kLoUgE8r24m6thojUG0n/JIrW2ZhlkmO7ZuOAkT7Ab1rVRpr29nWefofP7t2r3lwIu6V4gXTkRzhND3ivGisDQED08QsO2SMvCoQrqRMj360fvlo09asjAmlJKcIOH3nT6onz589Tb0KAgaBoFl2T5PN3vwcPMeqUpHpHBaQkY0TNijCaFckXEQH7pMNDPwhxtQAIgzw/UD8u3ouEGM2lq0SI3bNyhZ6WrLZ4kSKs75i5CCMrD82SAgXsICiG1N8JpcC9RMNodJkCRFiMqBkRls+k2/KZ9Fv5TPrX+Ux6lA97puUYv/27Dk99P+RVBSAs2rh/UQFKv5EQ85qapPoULS25sMojVWQ92Injx42fNPu6tHqzH405IGC2ihIB+g16iYbR7FgFjDGKEYkXYflM+o/zmfQ/M8a2MMau8PCZ/yGgVQMgCnTqQqySGjFKS5IhqnpXlT6jrPGk6JxNPdiMmTPUm4iCgaDJq7+ThQuarN+OrFe0KDQmwMSERIuwfCb9BYp0uUS5TPin8NYYgKpQJMQq8S4i2tetU29Or1LHlixOPnFywOqJl02cqN6EoTEIg061NszLfMnc4aKLH0TDYkJiRRhFwBhj+3z4jBjrAWqBTj4PsQB5F3l116eok9Y2Xw0TSXkSevfMGasnXn3VNPUmUpEgDPJq1PX6OXOs33Jg4JR6E5GwmJDkSBidBS6s8DVOp7I5eAOBWmGr6l1E7vpeh39v31Yk4Ko6UuXMGbsGZ8WagiESBkJEirAb52as31VrPoEIiwmJFGH5TLqJH/gr5WvV/SQAhE6bH95FJaJhmFMIgDtdIiVJFwK2ncq9PUUWMdOdHwmiRFIjYX/p8rf/R3WMjLEWPs5lGWPsu3zG3jAPC9O/K1LZnN2cEwDiT55HrWR9ykPrvGUTtWjY9JDrVOR7/ex98wZnsqcAoIr0iLeeNetaq7Wg7mSNKI0PAw44GZTGlnwmTQW5f+iw/r9mjM1MZXNqx2NPjD8uAEHQx+u4qKO4MFKFWuBthl8zJRpGrvyc1mr83t57z7wm7PJJk9Sb/c6PBCAQ+ri1C5sy1T4CTZ3JVM/JqUNNY/RJYiTMLRf+N5oAAwCUZiuPDhdYtmyZp8300sGD6s0lUR+poglNpHRA2MiLFK1L1wuIhMWAxEXCyrgFb3L5GwCgmDZu8VK4un7o4Q72jUfsUpMkaqiujNKanFaMAQLAERm5UiJaxhw+clSPhJVjq49F/G011MjS6ZPIbU2iCHO70kanEwDm9PFuSYpgseXLl1qLMGLPnmfZg1+TvkdxE2EpXicHQBiEnT6k97vfp9dqrZEGnDpxTKwQqj0fqql0JOwmALBGqq5Ckf7D9iIse+hV9eb0kNIk8mQ2ZcpUqyceP3FSvYlWfxA2w+L9vFrEWOCnD2atzKz063MWLkaTGAkDAPjHkBoNa2m5zToaRgX6JGyUodjNIUTDpAj75LhxVk88OXBKXddGNO+AkBnyarH0i/Pn1ZsmFxAUmOgWzQBU2L9jxw6r99y540nx38n8PZOecZKeh7u+v0ef2+kIXQwqGQEmBDBEGACgHB1ChJE4oatz207J/fsPqsIm0inJwVNFrf4Y/wJiw+BgkWu+aRNMpxBhNC3C9rd926JF7HM3SHPZpKck69WGnW9s6ChlDVKSF17sVu/uFmUOiR/gDQComCF+0CjwhXnzrF+vREoy6C5JGQmbfe0sqydq69qALjOQcIpMYm1LDl7rfU29mfSUpIyC/fDVrLEAI8NrbQqCTAMnUYS95fSHfCaN+o5icHIBpsiDBvl+2broi5SkQtAHaynCJk681OqJJda1aiOXAAgJ+fue02A3t/LZvbvZ2bPnxM3JCa+jlMctTXy6sqjldnUc2rA6oiqJIuzHLn9bEeJ6xAEnEYYuUqDTpRYM00HFlsNHimbbBZ3mk3Vcij2GMXv3Pqc+tC3q/mYAVIgUYZRatJkcQdGgVw4VjUxKajqyWdTqkegk8WlKU1NR9qBLvZFEEeZWRPtniIYZgS5SUAp58LC9WmZjBwyHUWvluctMu7qfgNmXIA5cemmRwavNcbxPnRCRmXuD1ad9/bWaSEnKz0Wi0zQVSYJW83wrqodNnAhLZXMkwj5w+PNvMMbeyGfSW/OZdFEUiG7nM+mH8pl0J/8XV74AFFN0tWybkty6pcgreXII6XB5QVY/Y6bVE+kA+/Qze9S72mFXAaLOpy65RF1D24yG/H3Pn29X90m/be2iJYlCTH4mTXS60rRgofrnft0LLqmF+W7eJ/+Bm9P9NJ9Jj4qFbjPGHuFdYPTvz/KZtH3OBYDk0qdGl5rmL7D+oCF7cEkRNjfTYP3k++5dqa9vF9KSIMHISDd1Mn/51kVWn1RLSSZNhLVycclOv/OufkHpysIFTeqfx3SFJ1WE/QVj7JcVvgZFzZ7RI2YA1DjyQH39HPuUpFYXFpoIo5OKTZ2LoKNjvXpzMn9NCDEQJNXav4q6oOc1zbd6csJTkvLzHMqa+YIRbavWqDWpI3o9GEuqCOPO+Ct9ejnUggDwEVLY2Fo/EG8NhurBNVRJnQvxV88/yx5eVyTEpkOIgYCRPlS2nl3ab9JLg5UUCbcstBNhCU5JpoSPGnHwwH7jJ2oXql2l6vQS6xOWyuYoJXmvHy/lw2sAkBTkQZqu8GyjSwMDoY8EkqUJixfbpVcENCHgr7v2qXcJIYYaMeA3fmZevDRYdaqeYRTJsSGhKUlpUUOpSLowM4FqZsnOR6FkmVSizVpT2dwTjLE7fEhNAgA+QkaXrr7mGqvNoh3AJoRwkSMPfCQabU8qgi/dstBJiMFDDPiJFGE0QsgWrQvP6zBweaFla8yc0JSk/I3v2WMmwIily4ocsYadnBsS75ifyubIzINaRh5njJ0zeMqYlwhgtQCIM567Dln4xfl5PvuywKJF3qJhjAsxLTVJIvIpFOwDH5Ep+nfPnLF61RJRaa8iTBaP23ZBU0qSokWcJKQk69T0sDZNwxWtw9SxWbAmxhZRjVgqm2tLZXMXM8Y+TduHH5jV5dcOT4dnFgDFyFqTq6ZNtd407555T70ZRkpPzmGhSIHtWBYVSk3SFa5S+8J4vcgQ6keBD8jfgzbDtCxaVNq8enwsRV3QWkSnLFrhetxFmIyCUWSSpmmYQJ2lyqxcVvMiTCWVzQ2lsrkDqWyuVV0YYxc6POW8w/0A1CpShNHAX1sGBjwNGa6EITUatnz5UmuPMxUqlp41a1ZhdpwCXfVv4dsGQ7+BV+S+c/SoXTryiuJ92msUTCCjYbaeYVrh+pKYR4mlCDtw4KDxk7TO0m637wMDvMvjOIuyUrhBbKPDgqJfEFWkCKPiXVtB84vzRdc1Ye3nHaLgmGrDHlrnPRrGuJnrTTfOLaQntagYpS6yKNwHHqgXXlS0T5kWgAu0zki3yTEmFHmG2TTg0HorKUkW42hYvRhTxPgUDVO0ztIxthQqQoQ5dWRU+kXGgnwm7VYocsqvz8BF17fymfSQYhCbdViOcSPZk/lMei0c/EHEkMX5DY0ZqzUbHAw9Esb4lai8ul9y52LPRfoqlJ6kqJhWtE+QO+wxnoaAGAMmyKiL1mVohFaUX+m5u8gzrOX2O6yenJCUpCwvoKi36ZgiKndQhnWPlDGPLyvCagXHg2Qqm3up0m2Qz6SvJ+HFRddaVV0bQPmebzHG/jmfSa+q8e8JRAdZK6nNqyvL2bNn1YeEeezpUMXj+o52a1fwUtDBmYr2b72tpVRH2xIuxnqQpgRlkCLMZiwO46agCsM+pCOZGsGxnTihpSQXxjQlKcXjSwfNU5HaXF1XAcaQjpRcZfg4a/KZNMWUX7MUXqW4iDG2OZ9J/11Q6wqABfJKW5tXVxYtzVLp78KWZtUHadOmjRXVh6nQ5/psenahkLmEGGvgEe8+2FqAErSqqUibsThsbJeyXxmsLjWFbxM5TkBKstnL90FpW+ooVYAIM8QpEvYvlbwoF0y3+byuf5LPpM0tewEImIkTL43TJh5SRRCdXLr37fNNiDFeuO8ixqZzW4s8T4/WehYCfIgsUnyx2/7wrkWqXGuQLMhXMqYs5ilJub42qWFtKke/ydQCiLAP+T2H+//V6wvmM+mdJJgqWCc3mvKZdJP3pwNQMfJq+7KJdulIxp2nFcKumaITy93iBhUe+y3EmCbGStSM0VX2/bxEQZi+ou6zNmlVI8J7dz9jtRFM5hNWgIzkkPu7zW8kxinJFC8jKGCTitSmcpSNgjGIsIJYog3+Ww5/9jJ7i16TflB/VtmalWVbwK8PQGCcKfYKq8bBuVMXYoeyWV9qxHRIjFHN2Oc//wX2nSee1LspGU9VPsWjdJ2oHaspUmoUjMS6qReVoMR8Qj/pUT3DFrXcbvzSMU5JyvWk9Ted3/mVpctVMcwgwsxxuwq3nxvxIX/JGLugzGOGuXfRf6EoZonluTIeZZdRt6XH9QOgUmRhvhevsIhQJMToALpzx3ZfuiZLQSfX++5dySZMuLhgbVEiVTmBX4FnuSDrQLoy8XSIKBiJ8+3b7K6tqQbJZD5hhcjXbGmxq67RxvzERYTJcgUtpeqKNuJpl6nR+0X+rHOscXOi8yrCPufytx+T/x2ZxpZ5jUK6J59Jv0EWMA6PuYsxtsHjOgJQCUVeYTFGnGCeEp9ly+aNBeNLEkxBQdYWtNBJlNr/qaZHu4qmE3M7X7p5/VhNWAbVEM08JV3g6Wf2WEfBmhYsVG86zieskE6+H0rPMNP1pDE/D35NXtQs5BcVfnRuBkUdj0wXME0NU5r2xrlFBfnGEUlEwhj7T05/SGVzXnfo33W4/3Qqm/sjAwGmcpPL3+ymJwMQEc6eK0rJVTva08kj0SPijq/es4L9KHfYyqTSC3Qya73rdvb7ky5nq1avLVU7xvjJK6s0FaB2LP7UqxEmmqdqK/rpxH/XHYvVuypzIHZmSB2DZOMZRvu3Nis26tEwuX603qZik9K0ysXoMESYHU4ngIo6Ix0wSy4r0NxLl7SknTdAiZev8PkAeEIbXRSFlJtwuJc+YmR++fzzz7FHH9sYygpQGzzVjk2ZMrWQrtROXoxHx55SUpX4/caTFN/fpAXC6lWrrT/I/avW6Cf+IFKRAvnatp5h+/cXFbZH3Z5Frp+23q5oaVqr76GcCHMbqyOWuB8ILnO4/6cBvJfXOZS/8nk9BNPNHgZATTDEi+IfFx+WTnKUTgkjKiYg81dKVX7mmqsLBrAOnZXtEGOxpF4VYMTqNWut05C0L1K0ViGoKJhARnYobU5F6KZQSlJheoTrHOvVc6K23o7Qd2E6rLsU5WrClqitmk7kM2n9L+cVe4d/Yoy9TStWQXqP3oMOjsvoAlVb7/d5AdxbfDmayuZeN3xNt53hDa/r6oLXVnyng+wHvq8hAOaMiJOJTZ1IxMnzcSU9/GBa+HwUFXv55ZcK3Y2Pb9lkPMKkUqjDjBZKPVHkg9JPSvRDiLE2XjO21bQYGFSFMQKMIp6m3Xcqax54QL0ZdBSM8f1ql9ADVIRuut4iJakIlWZ1hFiEkFEwGlNkejzT0rO9tjVvIhLm95XUOB46n8xrLQodP/lM+pf5TNq8x5WTz6S38ZoISoBfobz2ZC7KbmaM3csY20Lu9Hzm4q/ymfTP85l0Xz6TfjmfST9KMyK1wdhu+emXvX54F/7Y9gllIo3vB7COzKs1B6g55H5y+aRJSfvsXfyKvVu9k6IPR48eLcyHCxMSfVQzRHMq6cSttf6rkTG48UeTNj6+qkiAUcTTFure1VzZ20L6xDIaRkXoNp5hMUlJSj3wWq/52CgtPWsthoUIq7S2yJTfYIw9k8+kjftc85k0CRfz2OdHXMjF5XQu0h6kZgdlMPYoF20lSWVzByr4nE71ZJ/x8Fq3uvzNWCiS+OQi9KF8Jt2Zz6T/h8vDg0p/AhAn8vzAnFG9kigS9ciGdvb26XeqIsboxE2F/A5i7CkujuE1Fg3qePRLnmuoBsyrACPhQzNPFXoD8AZzokv8Dug3YOMZFoOUZKNqFfLs3t1GT/LDKFek9T5u+8QKWc99sExYbOC55Tck0v6ZMfYTnvL7O55iPZTK5v7B4L0GHDokf4PEUCqbs4k03eXytytJVNG/XHCqyyd5RPITHrbNHzHGKhGhACSJHn7S6OBRh0I0gw6+JMaWL1/Ktm/f6emkWgn0fnSyKJGmnM4zB4/zdUaKMnzE/lJUzkOiec2atfr8VGOe2Pak+j2PVCGq1CVsNZqa5hnv8zFIScrtSGOKTMsNNG+wLi+/NREJ+5ntEyvERhiEFaVTuYCLqAYeRXuEX8n0iygaT3XS8g5PefbQsG6KMnEB5MQXLdfFrXj+Eb4s4W3sDfzxk/n6exFgzKVZAYBaRpinPq5uAyHGRGTM7/FHbqhpyl3f36M/8n5ExUJHWE/8VBdgVGc0N5PxLMCoS1dLQ3ZUwXNLCieqk7RpVtm7tyjuErWUpExFvv6aWSqSfufa9+FJVAoRFlRtkROnLB77drirZoyIOl3GhU8DH9a9pEwBvlt6sQjeODAu/I8GgBFyP3/n9Ola2WKicP/TvFBZIsQY1Yx9+7vbQuumZFyMkd8YdVNq1haTeVQsioXQSaGeb98hXvc1JvpF80NvunGu54YOSnsppqdMMfANmyHVxkUzi3VFS/FFKSXZqtqFkFWMCfSdKgx7raUuZ1Gxy2GkjlhaGGOP8cepy3CZzj23eiSd/+7yt1/zg2Kcaphsdrw/DHA93Ag7PQ3iiSwyTkhnpA2iCH6MGKN0ERXwUzflCy92W7XzVwpFWcja4rFvbtJnVIqoGOwsKqOORxY7lPTTMb59J6uvTOKLar+ofs9LB6SA5plqdWD9VY4kSfG3cEGT8ZNIgFI0UCGshoJyyCjYi937jZ80f35RKtKzIC5nUTFkYCtRMrbKa6pKpsNS2ZzxHknu8vlM+lb8xowAACAASURBVN8chmy/n8rmLlfek34gN/Iaqc/yA85kHk2KyogmG4HjltYMEifHfwB8Yfa1s9SXifIYk3IIMdamLFKc0lw/Wtrb1xXm6FGBchiC9esPrmVHjx5hHR3tah3OdMULLakd0HU+emapadw6XWQ5QULjpYMHjSMqbpAAo3mmJerAqlnn1yXGfAnPMFORSV2HSgqPxE+1hViKl/IUOHjATITR96J5g3lujghEmHBbBacT+Y89vOSgQ23Up9QbfBzQTpd1orDx53mdGc13nOhhXSrl702fn8rmnstn0nuqMNngXYPHAOAXcRZhgjw/+W/lJ5cO9aRNJytKJ9FCJ2k6GVF6Jki/MeEx1vn0brbkTjneZgJvNGgNsasuTMTMzdCgiGPu8BHfv9MSAoxFREB79gyj7UMpew59V/VV/jwyCkaRS9N6vUUtLerN7kqOYUFFh9xqorz4b/2dgwgzXn8+/qdHGYzd4yDCfsWF0mf46/sZvv8lWQ1ZPod+dK9wew83fqU48o/wdPD7fOd4ny+0s/fxbSG2gd0MCgCAG3lemN3Jf7uteo0QRQJoeWDt6kIn1rN793ou1jaBasXeGhxUT34kxF5kjN0dgslnoiDBdeLkAHv3zBk2eGqwEG0M4rtzEGB3RyiC2SX2a21wtSsiJalEw1qrHA2T702RalO0z1zRbygoETbP5W/mA5k+4q1KV8iC86lsbkw3EU91CtV8HRdwn+BRtQl8W5Yqov+AiyISnx2Ww7sZd/8Pu0YriLmZIFnICy3Nqwp8hLjoa+Mnm1b1YpJOsCJdebyjvdA9FlR0jKwEBgZO6if2p/i/sRZi1BRCkwz85mfvv8/ee+9M4VXPnj0bqFBWofTe5k0bSwmwKH1PXWJiBq0ndQWb2lVEKCVZ52VMEX1WLT1cUUQ5KBH2e05/qGR0kc/8gcPLlWwo4OIJHUYAfIiMEJ858571JqH2doUkpCPdyCtjheq5GGtW05VUX0KRKoqOUXHw3t3P+F47JkRECSHWF+caMdpOSWkMIRsKrQuSRThi2Sk8w+Y0zPnQLMmACKUkZXMDdRSb7kPkj6ZQ8fcSdq2RV4KwaRjvcP9AAO8FAHAm6SJMpY9f+dNV+C36WCQSR1S/JTor/ba5ICG2dNlyvXOyJ8JDlWsC8pz621cO6QJshLsQRDVSKdeLIlum+2qJLslqdXrK99U8zByhz6hdQFYcmAldhJWZhejEYg/PAQAEh0zZnxywsf1jofpnRZwuHhH7NJ8iMqKuLqUpgxBjJYTYhIQW6ccC8gAjbznN+HOY/8aikjkqRZ/qGZaZe4PxE7XZjG4znIOiXo1Em44p0nzR+v24gAxKhP2Ty9+esHmhfCa9jjF2tcOfUbsEQJU5d+6c1Qpow7578f0VDuQdPMV7tzqnkilijLoc/XLjJyHW3rFevWs6yi3ChYQ1Rb+2bB5T/9Udga5BU2Q0bPHiRcZPovox5SJgchWmOsgoGEXlTOswNV80X34vQYmwp13+1sLH/Cx3iopREXw+k16bz6Tf4leITvwwkLUHAJRDHjT/0bKQ/NJLq+EMExs6eWrwbl2gUpqSIiZUN+QH5GOlFbTfjxFHwUNCmiYqPP/8c3r0iyKhq3hkKC7zPqUIIxsW6uo0hTqDFcJOScr306JyjlDDhDKsm/kVPRYizMlSwtOOwIvY/7fLQ+iqi379P+dzGP+vMotxlM/d+hZj7Ioyb/Wol/UDAFSMrCGyjYR96pKicbBRTrdUE2FxURQZo4gJ1Q39KHfYlxQlzZ3UxhwhGhYQ9H2R+CIhTRMVtOhXrzL+KE7k1bpGzT/LFW1GY5gpyWZ1TJFpV6c2rHuXX0JZiLAJDn+vJBz6FxaPvUiZxWjKgVQ29w8VrF9UHPQBiCOynsJ2JMu0aVPVm3G54q8WIjK2Sq0Zo+JgiqT4ERXrGJuWjNpw5VhDNV9U10cp5RLia5g3aDTGuEFFRsNsPMMoEqvVJYYlxOT7aNE4Ryh6SWUBCr41SwRWmM9HE50I6OUpynZnha/h1HEZ9jDzKIL5csANmbLy4hF22cRL1ZtJHZ/jN1u5GJNzKkVUjE7wldSKUX3YX3ftU+/ya+xPzULCi2r43j79TqHmSzuBMy6+7ubfadybIoRnWGGfpM9uiiaCwhBhKdU8mcZLmbCo5Xb1UcN+RvAD7Y5MZXPXUMmIzy9LxfhXCNf3AHAbPJ40nHYkt4kHAMj9w4tHmDZzDSLMnDyPUmXUqBid4Lv37atIiD34wFq9UBrRMAuoXohSjVRoPzo6WhBeVMOn1RAxTXwlaVqB/Cxa2s6VKqQki8YUmUbxW1puU2/6+r0FnpJLZXNX5jPpLnVIZgW8wBhbGqAAAwCUR4qww0eOWm0urXB3BOlIT/QoJ/HCcZWE7aFslq1Zs9aTszt1h5FJrDJjsg0jjT6C6rlEV++UKVPZJ8eNKwyhnzjx0lJCS0e4qncmuAZSGrdSswFdEJh0HFJKcn1Hu0jRipRkkJFBKcIOZc0as+m71y4c4yXC2IdCrJmP/SHZ+SeMsd+yeDrNQ/wBY2yt7cgfYMi4jzN2/pfYWsAUKcL6jr1ptdGmTUMUzCfyyqDwgv04iQFywz/25lFPo4/IpV8RYdPjYpNAUaidO/wfW1QhQnh11YgHWx+P8hVqRZcuW8G+/uBaoydSSlJJ1wYpwurUYNDBA/uNntRy+x3qzV6/a/dCK07nAuom9tEcxs8yxj7P/3wJn8PI+MHlHT5r8cdREF75TLpeq5MaSoggLJxML7jwY2y0+usC4kFKnbfW22NW2CqYMXOGehOdkZXTwU8KhTmQFFGg1OTCBQushRiNbYnYcOU4McyFiJgXWosXGFS3uIX+M3/+PGMRRilJTYQFhXxt6gg2jRjfsnC+etP36HBVOgS5gKElnImodozLZ9Jf4AefP6aO+lLPzmfS/4+POKII3UsR/BwmoAAf2FJ0ILM90V9V3BkJEeYP4sRQEGKUOnli25PsphvnWr94hIYrR40RRVgNaQv24w/pEiKM9kEqPTAROpSSXL16lUjrBpmSlHWO+/ebFeRTk4E2rNt3ERaX2ZFh8iWKVFJq20mAcT7GnfwP5jPp/+lxHFNUQdoXOCE7Iw8fsUtFUp0IivIDo1M1tiYhZdOlJtDGt0yOYZMOpYsuCGBJ8X2/kZ/MOxJe4+WFIdUzbF7TfOOX0OqzgmgKqVMj+NlDrxo9SWsyCCRNWssibMTgMab8IXWB8jRr/LjoQn2VIcKAEzIS9vprdhOHtDbvfhTl+06H6rJPBc+2HZMlhivDQR/YIIWKlsZzRavPWhhAlkZGdGn/ptR7OaggX5toEIiRbi2LML9PAL/DGPv7WEbEfvXrCKwEiAFFTtO2Jq2oBwuFZtWz6X4P0bA3jxZFOCHCgA2dXjzDKG2peQ76XRsmX890TJE2kLw/qMh9LYuwIwG85sQ4Gh2OjvyfCKwFiAHWTtMqmpt2LXSMVYO8egy6647F1tGwwcFT6k2IMGCL/G3beIZpKUk/RVijOuFDS7k7og0kD8yupZZF2N8G9LorE1YfBoBASUWaXU0KqEhXK3BFJCw4top5k7TNyS7ABi3COQENPMASmbYTnmEmBJiSlDVmNBnCpJmIjlea/xtEmN/wsUrlUpLknn+YMfYYd6mmZb5afFiCj4c8jBSAMGhVU5HU0WSDVqQLARY88qRBdgG2aEO9MUED2NCnDp3XakEdCTAlaX3xqA0i7w6yfrXWuyPJnORftfv+ndLGjLE5qWzuN1PZ3HWpbO7rqWyuhy80OJy+1MddXneRy98AiCPyapKc1W2Zm2lQn4FUZPBIEUYdqVRkbMO7xeOoIMKALXL/00b+uBJASrLZ9uKRInda6USgkyNqWoSlsrnXaZvzKfYbqXY4lc19PJXNNfC/ueFW+4WDFkgStD9LFUXO6jaQo7kW2ocIC54hXkxcYPZ1aas3HBgoqgtDOhLY4ukiIICUpPXFI0XulNKJ4aCPV7UeCSMhlk9lc12pbO6BVDZn3P3A51cOOPzZzV8MgLgh27tzbxwxau9W0Ypzd8GaIjTkyUPrTLUFIgzYMqTapWijfxzxOSWZ8jKmqKkpeG8wlZoXYRXyo1ivPQDlIe+7JeJRO3bssNpkJUL7iIKFh6y90yYVlOUfi4uXEdkHXpDRMK0cwZU9e4pc9isxbpUCjoSdiXs/RezS112r3hWIN5gKRFhlvB/nlQfAAJl2pwOZrTdY2KF9UISM7GuTCspy7tw5bElQKV3CM4zKEUw9wzQ3+wZ+IegFGcHv3nfA6OlaxK4/DONyiLDKgAgDSaZejYJt377T+qMuX75UvRlogSsYA9K+oJrk1Yuu6+fMMVoVKnfQunO9pCSLxhQd2OdmaPARWsQu8CgYgwgDALggD0JUC/aNR+x8iOnKVyvID+WgBoqQxfnUIAFAyMgLry82LzD2DNMGbHtJSUrhRoLOpI5VO16NhBW1hwirjHFxXnkAXGhVOyJta8GIRYuKnFpQkF8dsM1BNenx4hmmpSSne0hJylTk3r3PGT1Bi9R1hfXbgQirjGuDfHEAqkRKjVqRy7RtLRhFXbQC19iN8wIA+IK1Z1iFKcl62zFFFKGjSJ1CaKUTEGGV8UcOz8bVJ4gznarB4YMPrLX+KMuWLVNv7gqjwBUAEEk8eYZVkJKUj/3hq1mjMUXaaK/hMKd6QISRYsqkF+Uz6c58Jr3OdO5jPpOm8OgfOPz5Z/6uYWDA/wfotKneOu0d640OYipUW4EoGACAU2Qc3LRgodF2qSAlKUXYa71mY4q00V6h1q7WtAjLZ9LX5zNp6sXey7vA1jPGfp7PpN/OZ9L/NZ9JT3Z4HomXoy4v/ffBrbWvTHd4MUQtahMK428Rn5yuIm1nRBKrV69SbyIKVl1kXV9vT9Z4RepnzFRvGptYA+CAFDYLFzQZbSOPKcmiMUUmzUQ0rFuzcAnVRudj+Uy6lo34DjoU109ijN1HJ498Jv1vXJT18IUOSP/CGPsdl9d9JMB1DgOcNGuPlBqCJ0+we1ausN4I3/7uNr0jElGwiGAb0VRAeQWoFCls6Phg2qmrFdWbpCSlUHvlkNlFx7ym+erN7rDPfx+r1ZRUPpP+z4yx8QYP/U0uyhr4QtGjC10eP5zK5iBiQJwQAmyCWOc1a9Zan7Sp1uOuOxard62HoK8qjeLNtVEwZZlW7LAPEQYqJc+j4gW0UWaOaEX108tMb0ipIuz118xSkbcsLBJhoZtJ13I6stHgMV64M9jVBsBXhACTqemH1603GvGhs37DBt0dH75g1UXW0Jw5857Vilw8vuj6FOlI4AdS4NAoMxPPMLoQpLIIBbdomExF0kWHSSnFQw93qMeskWoYSteyCLsygNdsT2VzrwfwugAEwRgB9p0nnrQ2ZSUefWyjXozfhghK1ZEXmoePuJWwjkX7LhHNBH7QJTzDSPiYeoZpxfVudWHyb4eyvS4P+4g5DUXeYFWZ6FHLIuwSn1+PBNgGn18TgKAYI8DID+y+e1davx2lIf98ZVGNRzdmREYCKcL+0SK1TIXKCiMQYcBH5HGhqclTSnKyQ0oypXZ1Hzywv+zr0nHrczdk1LsgwkLmEy5vN2qxKlRsMR8CDMSIkgLsS7eYtY7rbN6yWQ/pexkzAvylyLDSpst11qyiKBhSkcBPZIkCRVtNPMMMU5LyPuqoNCmn0Kwy+qu1r9eyCHPyHPkglc3RdqHLwe/R2DyeVlGXAX61PyeVzV2eyubMRrQDUH3qeWTDFwHW+fRuvb27FWnISCDHttD3a8PMWUX2FKGZVoKawJNnmEFKUoowzeTVEc0qoypRMOKiar1xhPmAVi2VzVFvrNnQKQDiQSu/EpVdkLu+v4e13mVWm6FDRa1L7izqhnwcachIUMd9DwuYdokJ0rOLImEQYcBv6Bj0FONC6L57y786pSQf2dAuboqUpIhc1akXlZrJa0nIIkOz0qmaCINj/lh+FbUVAqBCUlwcPaUKMOqC9CrAqG7ogbWr1bv61ehLhKirwfSo7Kww7RIT0LQDLbUMEQb8psgzTKtBLEmZlKQ87uTeOFIweS2HZpGxq5rRe4iwsfw6aisUBHzskhNIJyWHZp4CkHF/cpK+9bYWT12QjBe07tyxXT9ZB2X5UiniqrurRjwR69Uo2PbtO62efP2com4xRDVBEOR5OU+BRS0tRm/hkpKU/z9woHwqkqwxyCJDoar7+cdS2VytXumcd7j/UyGvR7VwFGGpbA7FuPGnjkcxXlSjX3SlOGvWLE8+YIwfwLRCfMYFWBSFe7MiPhdyMRpVsegHKTWtQgXKNkI7aicnkGjkfqrtc47QvkwXkByRkixqQNE6KUtC1hian2F1RVg137zKIO0Ikog4Ef9UnRtIB6/HvrmJfTY92/P4GjpJd+/bpxfi3x3RDrpUCbNYEqNZfn8So2Jb1dqYjo71Vk+O2skJJJouHkEv7HNUX2pC7vAR9VGNalqS0pUmx7aWltvUm1WrBRMgHQlAMqjjB5Sfq+koxg9Ot956G/v6g2s9f1AXAVb1g5gDHeIKmQSocgVN3M+Fo8lA4LjQqX7vZLprG+1cvnypejOq3ytIDnIf00xTHXnz6Jvqn5rVyLaWriwJlVJoxzCIMABARTQqka8i8UVF2UuXrWA33TjXqFjVCQcBtivCJ+pGLrQK/Ldt2wsilNJzCpN5qrbHLTUfE4oEGIluW9NdikREpVsM1AxyHyPTVBPPMK3zsUGN/JqkIltuv0O92RsFI2KIMADiRz1PPQ3x9NoY8UWdj78/6XL2vZ3bK/pwLgIsyh2HMg1JwosigCRCP3PN1YWUrBYVa+ACtjOGYkyY7srvnz7vPStXWL+QFgXbBZd8EAIUjZaeYZm5N5R9R/odlxpGT/u9SSpybqZBvRmJCw2IMADiQbMivI7xSM9kdc3pQCTEl9fORxVqHT+UzcZNgHW41UWRIKOomNbuzriQiZMYa+QnMXlWoe9/4YIF1jV/NPdTi4JVvvMAYIYUQosXl7eqYA5zUE1mRZL9irKfj0Sl5hEiDIDoUa+Irh4+RuvFUsKLcUd0SjtSpMcP8cW4mSHZUGgn5/URF2B1qmcQGdGWqouiq2lK0dI201KUTBNjUeykFI0XWXVfoH2Avn9bAVZi7ud6RMFAiEgRZuoZduzNY2Pu6zv2ZsnHqmjeYF1R6eiuZRH2gdMf8pl0ktvYQfWp5yf4Rh516OAHhT4uuI4poquh1NpSJIeiXlOmTC2MHKo07ahCkZGdO57UbSjujkGEpFPYcVDK4hsb3FeXthkJF9qOJVIcS7jQGeKfu9rRsRRfjyE1/Si6Xr2OnVq/YYPu96Z3lAIQJEWeYfOa5pd9q8Nv5Ipu02+g3PGPyiq0Yd2R2c/LjS1q1QTJUImrpL5UNhdHc09HEVYj1IJxpRfG5KmiAIkECsPTCJoD+/d5tplwgw5UT2x7Uj9YiYHcUbcraFUF6/r1G4y3EUUPaaHidGpf19KvFG1q50s/j0x2hegk38yXJfofyPNt06ZNnj3fSGzTEGUFzP0E1aBT+PndsnB+2VC7qAsTUXrNtqIkFPVWGI6SrY4QYSOqoaPCmB9+KfKZtH7vsENIu8/lR256UDMWfdwVXr+CTfFIhNuVrRCfpUSnCUOpbC7QkH4+k673KKTE85yifeWT6yBQ6MruxMkBdnLgFHtrcLBw5VdJd6MJlH5sb1+npx/7+Yk56ua9RZ5gFCX0EhkUYoy2BaUuvti8QH/IdL6Izstevm36+HHC7fhmSr2Sjm4sdVymExA54VeSeqa0z4NfW6Pe1Q1fMFAlhGfYBIrKUu1WuVFbdEEqjlWabUVJtHqzSEV7hQjrc0p7eGRyqdqVMu/R7vK3IkqIPr8xEp9VXkcQU4TIIt49c4adOfMe+8X582xw8BTr7TEzHPQLin49tG7MIG7GT8pxiYzIoeS0bb10B6qQgKOFtg0ZmDY1zdMjRoIGh2OauJDJGwjYlHJhNN3tgX6IL6aMnVIYrsH5miBadInzLl0AlRNhNul3uuDQLi4jdbFRLh0JQOIhF/laxCH6RayKUW1Qo3rR9GL3ft9ELL2OiI4JQTZj5gw2+9pZpbaZiirMvBVrcUhUvnIoy146eNCXur8SY6dGeNQNaUhQTbaK3zGVQ9B+6tfvWJtN2R21xhMhwrp8joQBACIKRULWPPCAXvvFYpR+VClyvaeI3rlz56zNSsshBJmAtuHV11zDrrhySkGUjR8/Tq8l84SIklK6hTq+/Gy4cPB8a4vZ9w2SSR+PyBYyaFTDVcmEDxVtNmXkTIiFCOvkB1/XcDioCdCenlBcUo+MWxPE0R+qje+zW8QdX71nRcGUcfPmLb6KGBWq0StVp0fbuKHxw4P+pZdOZJ+65JKyryXa64NMRcdw7BSoPbaK3/H8+fN8EWHUbKNFfSNX91gQYbzQvZ4Xo4uCbVGroFLvUMAPksEwjBqTB52A71+1ht11x2LddoLx+qXWmItv4afWKS4kSWyQzcb1cxoKVhVh1dnR+4RZ02cCRe0oBRmjsVOgNukSIoz2Varl8tr5K6B6ToVI7u9FNWGpbK7HtvXaoUvPqXPPraMvrHToCA99/kfG2IWMsV8xxujM9L8YY7+rPTaVQNHZX6L+o4d3naI7KkHQyXf5ypWluvwYF9xtCeqI6+PHlw61yYeiftT2/q2Nm30zso0TVPe3edNGXXxHfeoBqE2GeM1WoY6SPMMqEWF0/NMaaiJZ51pxYX4qmytVTxCIh04+ky4VnXMjcKsIh/X0ah9hQ1z92UDAUAjepaNPRDuTGgURxrcyKkYC5JEN7YX5iOQfFlSKMmp8+7vbCqlZDaQgQZTpsvEMc6NpQVFPTH9ko/2jo6NYsCRhaRzl/Ch3eJQ7z9fM0rZqzegLL3aPjoycHXVgaHR0tLXG9vW20dHRvL45aP/4ytLlid03vnzrotGfHD+hf+x8DL7/HrGyNt8PPVahB8fz2C/yN0vHNa+/g7dPv6PuF5Hd9zE7EoAYQnVeZGr4wovdbGTkLNuyeWMh7ehQ83U3NyeutQjIVv65d6l3UoSQ6sV+cvxEIWqYFGif6Hx6N3v+ub16/Vc/r/VFBAzEAVkicf2cOZ5Wl9LwUfYGU4FPGAAxgE6wTfMXFCwRqPOvjB3CCD/hbkW3a6H+sVWZ0Sk9xWgbijRl974D7MC+7sAnEwRBmcaLx/nnRukCiAud4ndKF5ZePMO0Yd27orz/Q4QBEDGoK+iyyy4rCK5p06ayq6ZNLWcOypT26y6MnynJkJMYo21LtVO00Mij13pfY8/u3R25LkcdKjxuuf2OQu1MCfElXPDDmnEJgF/0qJ5hZJJs01RDok1rRop0BBgiDCQOMs6kcHRUGT9+fEFgCcjsk7j6qmmlTqZuDCvDpCG8zNDFWLPaAU0GtrRQhIwEGc2lyx56NTIRMhJembk3FHyUHKKhI/xzxWXiQUmmTJlq/Bumx4LE0Sm6nGmovo0II9GmMBz1C5ELqDAMgARANS/ZhH+R/dyKQVjJ1Hqq0Q9SXIi1uZlV09xGcrEfPDVYmPEZVoelMH8lv7PZ1850S0MPKynouKYee3ywKupVvC5BfKFazp+Ktf/8579gfCFEtZ7K7yTyJtSIhAEQPYa5wOpT/kVaKRjyXLx0cvubVi7KJqvvRilLNSVMhf3HT5xk7555jw0MnJID2BkfAG4LRbgunzRJuuxbpKF7lfUHICl4sniiUg7tQiXyvwtEwkBSqI9ZCqZPiViI/+cxxy8y1POISnMl0RkxC7IUDj5uJvTzk0tXwqKhWy19IEvRx6OaIN7I4nwqC7jpxrlGH4a6g5WxbLGIikKEAQBAecRIt3q+TA5xmyENDWqJFN/HC7Waq1avZVu3bDL6+GTXo9TVxsKYGCIMAADsSSmCLKX8W1eBQOvl//YoUdE+2EuAGoNKAp5ivBbz9yddbvTpyTeR/BI5IyFMrfEF1IQBAIA9eSUy5UYdX0oBgQXAWGQ6mfz7TNG8wWLTLQ4RBgAAwTGE9CEAxtSrXcpkoGwCNbaQtYxCbOqDMbYIAAAAAFFARsGoIN/UloK88xT649TgBBEGAAAAgGojPPsKvHTwoPHqLF68SL0ZK7sWFOYDAAAAoNp4KsgnbzAaWq/w23GqtUQkDAAAAADVxlNB/qKWFvVmd9yaXSDCAAAAAFBNPBXk01ivG+cWFeTHbnIERBgAAAAAqomngnwa1q2Ysw7HyZpCABEGAAAAgGrhuSC/qSme3mAqKMwHAAAAQLXwVJBP3mAvv/ySeten4+jJh0gYAAAAAKqFp4L8ltvvUG/2xtUUGSIMAAAAANXAU0E+MTfToN6MXUG+ACIMAAAAANXAU0E+DeuedPll4uZIXOvBGEQYAAAAAKqA54L86+fMUW92xXkQPgrzAQAAABA2ngryyRtscPCUehcZhfXE9dtDJAwAAAAAYeOpIH/pshXqzeE4CzAGEQYAAACAkGn0WpA/f36RN9jWuH9xEGEAAAAACJNW8V42Bfk0rPuaq69S74ptQb4AIgwAAAAAYVHHGFsi3uu5Z581ftsSw7pj6Q2mgsJ8AAAAAIQFRa8W0nvl3jjCPpuebfS2VJB/9OhRdVbkLYiEAQAAAACY0SgEGLFjxw7jJ1JBftyHdZcCkTAAAAAABA35gvUxxiYzyygY8fbpd1SD1vWMsY4kfGOIhAEAAAAgaLYKAUZs2rTJ+O0eerhDd8iPfVekACIMAAAAAEHSqhbjf+eJJ9lfPW9ekL98+VL15tY4O+TrQIQBAAAAICiahTM+42nI++5dafxWjz62MbFRMAYRBgAAAICAoAhYp3jps2fPsTtuX2z8TtQR+ecrl6t3JSoKxiDCAAAAABAAbTwCNoFxAbZ02XL21luDxu/00LoOtSMycVEw4qIIrAMAAAAAokMdjzh5iTrV1l1BJwAAArdJREFU8ehXg7hDCDCbOrCvLF3OltxZFDXrSFoUjCESBgAAAACNDu5G38lrukxo5t5dP1UF2PETJ60FGKUhV69epd7Vn8QoGINPGAAAAAA0+tQB25xeLszUUUF1fGkotQFpLuQ9K1dYpSCJzqd361GwGXydEgdEGAAAAAAEZKr680q2BnVAkhv+93Zut35u26o1bMvmjepdiTFmLQVEGAAAAAAENFooy3gt18jZs6pFhCOn33mXHT5ylD27d69V6lHly7cuYjt3bFeL8SkNWZ/kbwaF+QAAAAAQNIr/vHIoy750y0J2881/yi6fNIlNmTKVfXLcOPnAX5w/zwYHT7F3Tp9mP/jB31S0AakObNOmjXo3pGk9WmyBCAMAAACAQIqwY28eK/xbqcAqBwmw7n379Ihbs1Z/lkjQHQkAAAAAgUz/DQycDHyjCAF2zdVXqXffzRjrqYVvBDVhAAAAAGBcgBXCX1QPNmHCxYFuFAcB9jg3eq0JEAkDAAAAAFOjYCdODgS6QagI/1A2qwuwXbUkwBhqwgAAAADAkfVg1OkYFDSUm2ZCKkX4rNYiYAKIMAAAAAAwNRLWd+xN3zcIdVmu37CBpa+7Vv/T3eqg71oCIgwAAAAAKdUlv7cn69sGodqv+1etYV+9Z4X+pxEefUukG74JEGEAAAAAkFEwMl61HTVUCqr7WtTSwr7YvKDUn7sZY61JHMptA0QYAAAAABrVLUDjg04cP27lEUYRr6b5C1j9jJlsbqbByWl/mNd+0bDvmgcWFQAAAADocRrETbMgBWrB/vjx49lV06YW/n/1VdP0QnudYT4DsiZrv5yACAMAAAAAiaMlAWyFbv7aiHyVACIMAAAAAIwX5zfypd4pMlaGfh5VE0tN13yVAyIMAAAAAE6klKL9Or6o9HGhla/lLkdPMMb+P1KxqLwNqjFoAAAAAElFTkSuQmCC)"
- ],
"metadata": {
"id": "i9ZPeh5Gk2pX"
- }
+ },
+ "source": [
+ "![dspy_logo.png](data:image/png;base64,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)"
+ ]
},
{
"cell_type": "markdown",
+ "metadata": {
+ "id": "FH5S5Xm1lMC-"
+ },
"source": [
"In the **DSPy** framework, the primary data type utilized for interactions with various modules `Example`. Given the huge repository of datasets available through Hugging Face, there's a significant opportunity to leverage these resources within DSPy. However, to make these datasets compatible and fully utilizable, they need to be converted into the `Example` data format.\n",
"\n",
"Moreover, CSV files are a common format for storing and exchanging data, recognized for their simplicity and wide application across various domains. The conversion of data from CSV format into the `Example` format is a necessary requirement. But can we we do something to avoid this tedious process?\n",
"\n",
"Introducing `DataLoaders`, a module aimed at simplifying the task of importing dataset from diverse sources, including HuggingFace and CSV files, into the `Example` format. `DataLoaders` are designed to abstract away the complexities and boilerplate involved in data conversion, offering a user-friendly interface for loading, transforming, and preparing data for use within the DSPy framework. This addition significantly enhances the ease of use of DSPy."
- ],
- "metadata": {
- "id": "FH5S5Xm1lMC-"
- }
+ ]
},
{
"cell_type": "markdown",
- "source": [
- "# Setting Up"
- ],
"metadata": {
"id": "RqSZB2MqsTAQ"
- }
+ },
+ "source": [
+ "# Setting Up"
+ ]
},
{
"cell_type": "code",
@@ -57,144 +43,14 @@
},
"outputs": [
{
- "output_type": "stream",
- "name": "stdout",
- "text": [
- "Already up to date.\n",
- "Requirement already satisfied: pip in /usr/local/lib/python3.10/dist-packages (24.0)\n",
- "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n",
- "\u001b[0mObtaining file:///content/dspy\n",
- " Installing build dependencies ... \u001b[?25l\u001b[?25hdone\n",
- " Checking if build backend supports build_editable ... \u001b[?25l\u001b[?25hdone\n",
- " Getting requirements to build editable ... \u001b[?25l\u001b[?25hdone\n",
- " Preparing editable metadata (pyproject.toml) ... \u001b[?25l\u001b[?25hdone\n",
- "Collecting backoff~=2.2.1 (from dspy-ai==2.1.10)\n",
- " Downloading backoff-2.2.1-py3-none-any.whl (15 kB)\n",
- "Requirement already satisfied: joblib~=1.3.2 in /usr/local/lib/python3.10/dist-packages (from dspy-ai==2.1.10) (1.3.2)\n",
- "Collecting openai<2.0.0,>=0.28.1 (from dspy-ai==2.1.10)\n",
- " Downloading openai-1.12.0-py3-none-any.whl.metadata (18 kB)\n",
- "Collecting pandas~=2.1.1 (from dspy-ai==2.1.10)\n",
- " Downloading pandas-2.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (18 kB)\n",
- "Collecting regex~=2023.10.3 (from dspy-ai==2.1.10)\n",
- " Downloading regex-2023.10.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (40 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m40.9/40.9 kB\u001b[0m \u001b[31m2.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hCollecting ujson~=5.8.0 (from dspy-ai==2.1.10)\n",
- " Downloading ujson-5.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (8.7 kB)\n",
- "Requirement already satisfied: tqdm~=4.66.1 in /usr/local/lib/python3.10/dist-packages (from dspy-ai==2.1.10) (4.66.1)\n",
- "Collecting datasets~=2.14.6 (from dspy-ai==2.1.10)\n",
- " Downloading datasets-2.14.7-py3-none-any.whl.metadata (19 kB)\n",
- "Requirement already satisfied: requests~=2.31.0 in /usr/local/lib/python3.10/dist-packages (from dspy-ai==2.1.10) (2.31.0)\n",
- "Collecting optuna~=3.4.0 (from dspy-ai==2.1.10)\n",
- " Downloading optuna-3.4.0-py3-none-any.whl.metadata (17 kB)\n",
- "Requirement already satisfied: numpy>=1.17 in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (1.25.2)\n",
- "Requirement already satisfied: pyarrow>=8.0.0 in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (10.0.1)\n",
- "Requirement already satisfied: pyarrow-hotfix in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (0.6)\n",
- "Collecting dill<0.3.8,>=0.3.0 (from datasets~=2.14.6->dspy-ai==2.1.10)\n",
- " Downloading dill-0.3.7-py3-none-any.whl.metadata (9.9 kB)\n",
- "Requirement already satisfied: xxhash in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (3.4.1)\n",
- "Collecting multiprocess (from datasets~=2.14.6->dspy-ai==2.1.10)\n",
- " Downloading multiprocess-0.70.16-py310-none-any.whl.metadata (7.2 kB)\n",
- "Requirement already satisfied: fsspec<=2023.10.0,>=2023.1.0 in /usr/local/lib/python3.10/dist-packages (from fsspec[http]<=2023.10.0,>=2023.1.0->datasets~=2.14.6->dspy-ai==2.1.10) (2023.6.0)\n",
- "Requirement already satisfied: aiohttp in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (3.9.3)\n",
- "Requirement already satisfied: huggingface-hub<1.0.0,>=0.14.0 in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (0.20.3)\n",
- "Requirement already satisfied: packaging in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (23.2)\n",
- "Requirement already satisfied: pyyaml>=5.1 in /usr/local/lib/python3.10/dist-packages (from datasets~=2.14.6->dspy-ai==2.1.10) (6.0.1)\n",
- "Requirement already satisfied: anyio<5,>=3.5.0 in /usr/local/lib/python3.10/dist-packages (from openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (3.7.1)\n",
- "Requirement already satisfied: distro<2,>=1.7.0 in /usr/lib/python3/dist-packages (from openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (1.7.0)\n",
- "Collecting httpx<1,>=0.23.0 (from openai<2.0.0,>=0.28.1->dspy-ai==2.1.10)\n",
- " Downloading httpx-0.26.0-py3-none-any.whl.metadata (7.6 kB)\n",
- "Requirement already satisfied: pydantic<3,>=1.9.0 in /usr/local/lib/python3.10/dist-packages (from openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (2.6.1)\n",
- "Requirement already satisfied: sniffio in /usr/local/lib/python3.10/dist-packages (from openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (1.3.0)\n",
- "Requirement already satisfied: typing-extensions<5,>=4.7 in /usr/local/lib/python3.10/dist-packages (from openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (4.9.0)\n",
- "Collecting alembic>=1.5.0 (from optuna~=3.4.0->dspy-ai==2.1.10)\n",
- " Downloading alembic-1.13.1-py3-none-any.whl.metadata (7.4 kB)\n",
- "Collecting colorlog (from optuna~=3.4.0->dspy-ai==2.1.10)\n",
- " Downloading colorlog-6.8.2-py3-none-any.whl.metadata (10 kB)\n",
- "Requirement already satisfied: sqlalchemy>=1.3.0 in /usr/local/lib/python3.10/dist-packages (from optuna~=3.4.0->dspy-ai==2.1.10) (2.0.25)\n",
- "Requirement already satisfied: python-dateutil>=2.8.2 in /usr/local/lib/python3.10/dist-packages (from pandas~=2.1.1->dspy-ai==2.1.10) (2.8.2)\n",
- "Requirement already satisfied: pytz>=2020.1 in /usr/local/lib/python3.10/dist-packages (from pandas~=2.1.1->dspy-ai==2.1.10) (2023.4)\n",
- "Collecting tzdata>=2022.1 (from pandas~=2.1.1->dspy-ai==2.1.10)\n",
- " Downloading tzdata-2024.1-py2.py3-none-any.whl.metadata (1.4 kB)\n",
- "Requirement already satisfied: charset-normalizer<4,>=2 in /usr/local/lib/python3.10/dist-packages (from requests~=2.31.0->dspy-ai==2.1.10) (3.3.2)\n",
- "Requirement already satisfied: idna<4,>=2.5 in /usr/local/lib/python3.10/dist-packages (from requests~=2.31.0->dspy-ai==2.1.10) (3.6)\n",
- "Requirement already satisfied: urllib3<3,>=1.21.1 in /usr/local/lib/python3.10/dist-packages (from requests~=2.31.0->dspy-ai==2.1.10) (2.0.7)\n",
- "Requirement already satisfied: certifi>=2017.4.17 in /usr/local/lib/python3.10/dist-packages (from requests~=2.31.0->dspy-ai==2.1.10) (2024.2.2)\n",
- "Collecting Mako (from alembic>=1.5.0->optuna~=3.4.0->dspy-ai==2.1.10)\n",
- " Downloading Mako-1.3.2-py3-none-any.whl.metadata (2.9 kB)\n",
- "Requirement already satisfied: exceptiongroup in /usr/local/lib/python3.10/dist-packages (from anyio<5,>=3.5.0->openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (1.2.0)\n",
- "Requirement already satisfied: aiosignal>=1.1.2 in /usr/local/lib/python3.10/dist-packages (from aiohttp->datasets~=2.14.6->dspy-ai==2.1.10) (1.3.1)\n",
- "Requirement already satisfied: attrs>=17.3.0 in /usr/local/lib/python3.10/dist-packages (from aiohttp->datasets~=2.14.6->dspy-ai==2.1.10) (23.2.0)\n",
- "Requirement already satisfied: frozenlist>=1.1.1 in /usr/local/lib/python3.10/dist-packages (from aiohttp->datasets~=2.14.6->dspy-ai==2.1.10) (1.4.1)\n",
- "Requirement already satisfied: multidict<7.0,>=4.5 in /usr/local/lib/python3.10/dist-packages (from aiohttp->datasets~=2.14.6->dspy-ai==2.1.10) (6.0.5)\n",
- "Requirement already satisfied: yarl<2.0,>=1.0 in /usr/local/lib/python3.10/dist-packages (from aiohttp->datasets~=2.14.6->dspy-ai==2.1.10) (1.9.4)\n",
- "Requirement already satisfied: async-timeout<5.0,>=4.0 in /usr/local/lib/python3.10/dist-packages (from aiohttp->datasets~=2.14.6->dspy-ai==2.1.10) (4.0.3)\n",
- "Collecting httpcore==1.* (from httpx<1,>=0.23.0->openai<2.0.0,>=0.28.1->dspy-ai==2.1.10)\n",
- " Downloading httpcore-1.0.2-py3-none-any.whl.metadata (20 kB)\n",
- "Collecting h11<0.15,>=0.13 (from httpcore==1.*->httpx<1,>=0.23.0->openai<2.0.0,>=0.28.1->dspy-ai==2.1.10)\n",
- " Downloading h11-0.14.0-py3-none-any.whl (58 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m58.3/58.3 kB\u001b[0m \u001b[31m5.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hRequirement already satisfied: filelock in /usr/local/lib/python3.10/dist-packages (from huggingface-hub<1.0.0,>=0.14.0->datasets~=2.14.6->dspy-ai==2.1.10) (3.13.1)\n",
- "Requirement already satisfied: annotated-types>=0.4.0 in /usr/local/lib/python3.10/dist-packages (from pydantic<3,>=1.9.0->openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (0.6.0)\n",
- "Requirement already satisfied: pydantic-core==2.16.2 in /usr/local/lib/python3.10/dist-packages (from pydantic<3,>=1.9.0->openai<2.0.0,>=0.28.1->dspy-ai==2.1.10) (2.16.2)\n",
- "Requirement already satisfied: six>=1.5 in /usr/local/lib/python3.10/dist-packages (from python-dateutil>=2.8.2->pandas~=2.1.1->dspy-ai==2.1.10) (1.16.0)\n",
- "Requirement already satisfied: greenlet!=0.4.17 in /usr/local/lib/python3.10/dist-packages (from sqlalchemy>=1.3.0->optuna~=3.4.0->dspy-ai==2.1.10) (3.0.3)\n",
- "INFO: pip is looking at multiple versions of multiprocess to determine which version is compatible with other requirements. This could take a while.\n",
- "Collecting multiprocess (from datasets~=2.14.6->dspy-ai==2.1.10)\n",
- " Downloading multiprocess-0.70.15-py310-none-any.whl.metadata (7.2 kB)\n",
- "Requirement already satisfied: MarkupSafe>=0.9.2 in /usr/local/lib/python3.10/dist-packages (from Mako->alembic>=1.5.0->optuna~=3.4.0->dspy-ai==2.1.10) (2.1.5)\n",
- "Downloading datasets-2.14.7-py3-none-any.whl (520 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m520.4/520.4 kB\u001b[0m \u001b[31m21.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading openai-1.12.0-py3-none-any.whl (226 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m226.7/226.7 kB\u001b[0m \u001b[31m22.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading optuna-3.4.0-py3-none-any.whl (409 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m409.6/409.6 kB\u001b[0m \u001b[31m34.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading pandas-2.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.3 MB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m12.3/12.3 MB\u001b[0m \u001b[31m92.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading regex-2023.10.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (773 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m773.9/773.9 kB\u001b[0m \u001b[31m52.9 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading ujson-5.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (53 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m53.9/53.9 kB\u001b[0m \u001b[31m5.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading alembic-1.13.1-py3-none-any.whl (233 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m233.4/233.4 kB\u001b[0m \u001b[31m22.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading dill-0.3.7-py3-none-any.whl (115 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m115.3/115.3 kB\u001b[0m \u001b[31m11.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading httpx-0.26.0-py3-none-any.whl (75 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m75.9/75.9 kB\u001b[0m \u001b[31m8.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading httpcore-1.0.2-py3-none-any.whl (76 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m76.9/76.9 kB\u001b[0m \u001b[31m8.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading tzdata-2024.1-py2.py3-none-any.whl (345 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m345.4/345.4 kB\u001b[0m \u001b[31m30.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading colorlog-6.8.2-py3-none-any.whl (11 kB)\n",
- "Downloading multiprocess-0.70.15-py310-none-any.whl (134 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m134.8/134.8 kB\u001b[0m \u001b[31m14.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hDownloading Mako-1.3.2-py3-none-any.whl (78 kB)\n",
- "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m78.7/78.7 kB\u001b[0m \u001b[31m8.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
- "\u001b[?25hBuilding wheels for collected packages: dspy-ai\n",
- " Building editable for dspy-ai (pyproject.toml) ... \u001b[?25l\u001b[?25hdone\n",
- " Created wheel for dspy-ai: filename=dspy_ai-2.1.10-0.editable-py3-none-any.whl size=15381 sha256=a7d7a53dbcdb151dab69c7177d37bcf850bb4c2f965c51975c8aaf4b6959601b\n",
- " Stored in directory: /tmp/pip-ephem-wheel-cache-ypxzl_a1/wheels/80/c7/dd/82bee9a1efa54dd8a664012a2537077eafe45c01781e3e9d68\n",
- "Successfully built dspy-ai\n",
- "Installing collected packages: ujson, tzdata, regex, Mako, h11, dill, colorlog, backoff, pandas, multiprocess, httpcore, alembic, optuna, httpx, openai, datasets, dspy-ai\n",
- " Attempting uninstall: regex\n",
- " Found existing installation: regex 2023.12.25\n",
- " Uninstalling regex-2023.12.25:\n",
- " Successfully uninstalled regex-2023.12.25\n",
- " Attempting uninstall: pandas\n",
- " Found existing installation: pandas 1.5.3\n",
- " Uninstalling pandas-1.5.3:\n",
- " Successfully uninstalled pandas-1.5.3\n",
- "\u001b[31mERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.\n",
- "lida 0.0.10 requires fastapi, which is not installed.\n",
- "lida 0.0.10 requires kaleido, which is not installed.\n",
- "lida 0.0.10 requires python-multipart, which is not installed.\n",
- "lida 0.0.10 requires uvicorn, which is not installed.\n",
- "llmx 0.0.15a0 requires cohere, which is not installed.\n",
- "llmx 0.0.15a0 requires tiktoken, which is not installed.\n",
- "bigframes 0.20.1 requires pandas<2.1.4,>=1.5.0, but you have pandas 2.1.4 which is incompatible.\n",
- "google-colab 1.0.0 requires pandas==1.5.3, but you have pandas 2.1.4 which is incompatible.\u001b[0m\u001b[31m\n",
- "\u001b[0mSuccessfully installed Mako-1.3.2 alembic-1.13.1 backoff-2.2.1 colorlog-6.8.2 datasets-2.14.7 dill-0.3.7 dspy-ai-2.1.10 h11-0.14.0 httpcore-1.0.2 httpx-0.26.0 multiprocess-0.70.15 openai-1.12.0 optuna-3.4.0 pandas-2.1.4 regex-2023.10.3 tzdata-2024.1 ujson-5.8.0\n",
- "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n",
- "\u001b[0m"
+ "ename": "ModuleNotFoundError",
+ "evalue": "No module named 'pkg_resources'",
+ "output_type": "error",
+ "traceback": [
+ "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+ "\u001b[0;31mModuleNotFoundError\u001b[0m Traceback (most recent call last)",
+ "Cell \u001b[0;32mIn[1], line 20\u001b[0m\n\u001b[1;32m 17\u001b[0m \u001b[38;5;66;03m# Set up the cache for this notebook\u001b[39;00m\n\u001b[1;32m 18\u001b[0m os\u001b[38;5;241m.\u001b[39menviron[\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mDSP_NOTEBOOK_CACHEDIR\u001b[39m\u001b[38;5;124m\"\u001b[39m] \u001b[38;5;241m=\u001b[39m os\u001b[38;5;241m.\u001b[39mpath\u001b[38;5;241m.\u001b[39mjoin(repo_path, \u001b[38;5;124m'\u001b[39m\u001b[38;5;124mcache\u001b[39m\u001b[38;5;124m'\u001b[39m)\n\u001b[0;32m---> 20\u001b[0m \u001b[38;5;28;01mimport\u001b[39;00m \u001b[38;5;21;01mpkg_resources\u001b[39;00m \u001b[38;5;66;03m# Install the package if it's not installed\u001b[39;00m\n\u001b[1;32m 21\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m \u001b[38;5;129;01mnot\u001b[39;00m \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mdspy-ai\u001b[39m\u001b[38;5;124m\"\u001b[39m \u001b[38;5;129;01min\u001b[39;00m {pkg\u001b[38;5;241m.\u001b[39mkey \u001b[38;5;28;01mfor\u001b[39;00m pkg \u001b[38;5;129;01min\u001b[39;00m pkg_resources\u001b[38;5;241m.\u001b[39mworking_set}:\n\u001b[1;32m 22\u001b[0m get_ipython()\u001b[38;5;241m.\u001b[39msystem(\u001b[38;5;124m'\u001b[39m\u001b[38;5;124mpip install -U pip\u001b[39m\u001b[38;5;124m'\u001b[39m)\n",
+ "\u001b[0;31mModuleNotFoundError\u001b[0m: No module named 'pkg_resources'"
]
}
],
@@ -227,6 +83,9 @@
},
{
"cell_type": "markdown",
+ "metadata": {
+ "id": "PtBml664suSx"
+ },
"source": [
"# Using `DataLoader`\n",
"\n",
@@ -236,13 +95,24 @@
"* CSV Files using `from_csv()` method.\n",
"\n",
"We'll start by initializing the `DataLoader` object that takes same argument as that of [`Dataset`](https://github.com/stanfordnlp/dspy/blob/main/dspy/datasets/dataset.py) class which are dataset size (in % format) and seed for each of the three splits: `train`, `dev` and `test`."
- ],
- "metadata": {
- "id": "PtBml664suSx"
- }
+ ]
},
{
"cell_type": "code",
+ "execution_count": 2,
+ "metadata": {
+ "id": "UeB7AEvhshfe"
+ },
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "/home/krypticmouse/.cache/pypoetry/virtualenvs/dspy-74wouE_3-py3.10/lib/python3.10/site-packages/tqdm/auto.py:21: TqdmWarning: IProgress not found. Please update jupyter and ipywidgets. See https://ipywidgets.readthedocs.io/en/stable/user_install.html\n",
+ " from .autonotebook import tqdm as notebook_tqdm\n"
+ ]
+ }
+ ],
"source": [
"import dspy\n",
"from dspy.datasets import DataLoader\n",
@@ -252,15 +122,13 @@
" dev_size = 0.3,\n",
" test_size = 0.2,\n",
")"
- ],
- "metadata": {
- "id": "UeB7AEvhshfe"
- },
- "execution_count": 21,
- "outputs": []
+ ]
},
{
"cell_type": "markdown",
+ "metadata": {
+ "id": "RR8vp-IWv-N0"
+ },
"source": [
"## Loading from HuggingFace\n",
"\n",
@@ -271,46 +139,45 @@
"* `fields`: An optional list of strings specifying which fields to include in the final datasets. If None, all fields in the dataset are included.\n",
"* `splits`: A string or list of strings specifying which splits of the dataset to load. If None, the entire dataset is loaded. If it's a list of splits, **it'll concatinate all the splits into 1 split**.\n",
"* `revision`: An optional string specifying the version of the dataset to load. Same parameter as that of datasets library."
- ],
- "metadata": {
- "id": "RR8vp-IWv-N0"
- }
+ ]
},
{
"cell_type": "code",
+ "execution_count": 3,
+ "metadata": {
+ "id": "OslWdJbMvVYU"
+ },
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Downloading readme: 100%|██████████| 8.20k/8.20k [00:00<00:00, 10.7MB/s]\n",
+ "Downloading data: 100%|██████████| 13.1M/13.1M [00:20<00:00, 649kB/s]\n",
+ "Generating train split: 15011 examples [00:00, 518904.00 examples/s]\n"
+ ]
+ }
+ ],
"source": [
"dl.from_huggingface(\n",
" \"databricks/databricks-dolly-15k\",\n",
" fields=[\"instruction\", \"context\", \"response\"],\n",
" splits=\"train\" # or splits = [\"train\", \"test\"]\n",
")"
- ],
- "metadata": {
- "id": "OslWdJbMvVYU"
- },
- "execution_count": 22,
- "outputs": []
+ ]
},
{
"cell_type": "markdown",
- "source": [
- "Once the above code is executed the data would be populated in the `train`, `dev`, and `test` properties of the object:"
- ],
"metadata": {
"id": "RRyYfcTUF121"
- }
+ },
+ "source": [
+ "Once the above code is executed the data would be populated in the `train`, `dev`, and `test` properties of the object:"
+ ]
},
{
"cell_type": "code",
- "source": [
- "dolly_train_set = dl.train\n",
- "dolly_dev_set = dl.dev\n",
- "dolly_test_set = dl.test\n",
- "\n",
- "print(f\"Number of examples in train set: {len(dolly_train_set)}\")\n",
- "print(f\"Number of examples in dev set: {len(dolly_dev_set)}\")\n",
- "print(f\"Number of examples in test set: {len(dolly_test_set)}\")"
- ],
+ "execution_count": 4,
"metadata": {
"colab": {
"base_uri": "https://localhost:8080/"
@@ -318,21 +185,32 @@
"id": "CIj3Tkj6zWTq",
"outputId": "6ff849e1-c6f5-453c-d328-ce78a24e15a9"
},
- "execution_count": 23,
"outputs": [
{
- "output_type": "stream",
"name": "stdout",
+ "output_type": "stream",
"text": [
"Number of examples in train set: 7505\n",
"Number of examples in dev set: 2251\n",
"Number of examples in test set: 1501\n"
]
}
+ ],
+ "source": [
+ "dolly_train_set = dl.train\n",
+ "dolly_dev_set = dl.dev\n",
+ "dolly_test_set = dl.test\n",
+ "\n",
+ "print(f\"Number of examples in train set: {len(dolly_train_set)}\")\n",
+ "print(f\"Number of examples in dev set: {len(dolly_dev_set)}\")\n",
+ "print(f\"Number of examples in test set: {len(dolly_test_set)}\")"
]
},
{
"cell_type": "markdown",
+ "metadata": {
+ "id": "WJ78GF1kPn9N"
+ },
"source": [
"## Loading from CSV\n",
"\n",
@@ -340,13 +218,23 @@
"\n",
"* `file_path`: The file path of the CSV file to load.\n",
"* `fields`: An optional list of strings specifying which columns to include in the final datasets. If None, all columns in the dataset are included."
- ],
- "metadata": {
- "id": "WJ78GF1kPn9N"
- }
+ ]
},
{
"cell_type": "code",
+ "execution_count": 5,
+ "metadata": {
+ "id": "tkK14QOVQwph"
+ },
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Generating train split: 100 examples [00:00, 27541.56 examples/s]\n"
+ ]
+ }
+ ],
"source": [
"dl = DataLoader(\n",
" train_size = 1.0, # Must be float\n",
@@ -356,29 +244,20 @@
" \"dolly_subset_100_rows.csv\",\n",
" fields=[\"instruction\", \"context\", \"response\"],\n",
")"
- ],
- "metadata": {
- "id": "tkK14QOVQwph"
- },
- "execution_count": 26,
- "outputs": []
+ ]
},
{
"cell_type": "markdown",
- "source": [
- "Once the above code is executed the data would be populated in the `train`, `dev`, and `test` properties of the object:"
- ],
"metadata": {
"id": "q2Zcn1X2RPr_"
- }
+ },
+ "source": [
+ "Once the above code is executed the data would be populated in the `train`, `dev`, and `test` properties of the object:"
+ ]
},
{
"cell_type": "code",
- "source": [
- "dolly_train_set = dl.train\n",
- "\n",
- "print(f\"Number of examples in train set: {len(dolly_train_set)}\")"
- ],
+ "execution_count": 6,
"metadata": {
"colab": {
"base_uri": "https://localhost:8080/"
@@ -386,25 +265,52 @@
"id": "TIrNy_wrQ4B5",
"outputId": "cd16d1d1-519a-4bbb-9c79-b89ce2f8e861"
},
- "execution_count": 27,
"outputs": [
{
- "output_type": "stream",
"name": "stdout",
+ "output_type": "stream",
"text": [
"Number of examples in train set: 100\n"
]
}
+ ],
+ "source": [
+ "dolly_train_set = dl.train\n",
+ "\n",
+ "print(f\"Number of examples in train set: {len(dolly_train_set)}\")"
]
},
{
"cell_type": "code",
- "source": [],
+ "execution_count": null,
"metadata": {
"id": "r4K2TWkRWdDR"
},
- "execution_count": null,
- "outputs": []
+ "outputs": [],
+ "source": []
}
- ]
-}
\ No newline at end of file
+ ],
+ "metadata": {
+ "colab": {
+ "provenance": []
+ },
+ "kernelspec": {
+ "display_name": "Python 3",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.10.12"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 0
+}