Memory API GUI

Add New Memory

\n );\n}\n\n// Client-side rendering\nfunction client() {\n createRoot(document.getElementById(\"root\")).render();\n}\nif (typeof document !== \"undefined\") { client(); }\n\n// Server-side code\nconst app = new Hono();\n\nconst getMemoriesKey = (): string => {\n return `memories_${\"gpt_memory\"}`;\n};\n\nconst getMemories = async () => {\n const { blob } = await import(\"https://esm.town/v/std/blob\");\n return await blob.getJSON(getMemoriesKey(), []);\n};\n\nconst setMemories = async (memories: any) => {\n const { blob } = await import(\"https://esm.town/v/std/blob\");\n await blob.setJSON(getMemoriesKey(), memories);\n};\n\nconst verifyRequest = (c): { error: any } => {\n const expectedKey = c.env.API_KEY;\n const providedKey = c.req.header('x-val-token');\n \n if (!providedKey || providedKey !== expectedKey) {\n return { error: c.json({ error: \"Unauthorized\" }, 401) };\n }\n return { error: null };\n};\n\nconst validateMemoryFields = (data: any): { isValid: boolean; error?: string } => {\n const requiredFields = ['name', 'description', 'summary', 'reason'];\n for (const field of requiredFields) {\n if (!data[field] || typeof data[field] !== 'string' || data[field].trim() === '') {\n return { isValid: false, error: `Missing or invalid ${field}` };\n }\n }\n return { isValid: true };\n};\n\n// GET ALL MEMORIES\napp.get(\"/memory\", async (c) => {\n const { error } = verifyRequest(c);\n if (error != null) return error;\n\n const memories = (await getMemories())\n .map(memory => ({\n id: memory.id,\n name: memory.name,\n summary: memory.summary ?? \"Missing summary\",\n reason: memory.reason,\n }));\n return c.json({ memories });\n});\n\n// ADD NEW MEMORY\napp.post(\"/memory\", async (c) => {\n const { error } = verifyRequest(c);\n if (error != null) return error;\n\n let data;\n try {\n data = await c.req.json();\n } catch (e) {\n return c.json({ error: \"Bad Request: Invalid JSON\" }, 400);\n }\n\n const validation = validateMemoryFields(data);\n if (!validation.isValid) {\n return c.json({ error: `Bad Request: ${validation.error}` }, 400);\n }\n\n const { name, description, summary, reason } = data;\n const id = uuidv4();\n const newMemory = { id, name, description, summary, reason };\n\n let memories = await getMemories();\n memories.push(newMemory);\n await setMemories(memories);\n\n return c.json({ id });\n});\n\n// DELETE SPECIFIED MEMORY\napp.delete(\"/memory/:id\", async (c) => {\n const { error } = verifyRequest(c);\n if (error != null) return error;\n\n const id = c.req.param(\"id\");\n\n let memories = await getMemories();\n memories = memories.filter(memory => memory.id !== id);\n await setMemories(memories);\n\n return c.json({ message: \"Memory deleted successfully\" });\n});\n\n// Serve the GUI\napp.get(\"/\", (c) => {\n return c.html(`\n \n \n \n \n \n Memory API GUI\n \n \n \n

\n \n \n \n \n `);\n});\n\nexport default async function server(req: Request): Promise {\n return app.fetch(req);\n}\n\nconst css = `\n body {\n font-family: Arial, sans-serif;\n max-width: 800px;\n margin: 0 auto;\n padding: 20px;\n }\n input, button {\n margin: 5px;\n padding: 5px;\n }\n ul {\n list-style-type: none;\n padding: 0;\n }\n li {\n border: 1px solid #ddd;\n margin: 10px 0;\n padding: 10px;\n }\n`;","deleted","label",[128],"a31d90ae-26c4-11f0-9a82-569c3dd06744","README.md","a31d9126-26c4-11f0-9a82-569c3dd06744",["D",1727017248599],"A simple Rest API that allows for you GPT to save and recall snippets of data (memories). You can read my blog post explaining it in detail here: [xkonti.tech](https://xkonti.tech/blog/giving-gpt-memory/)\n\n# Demonstration\n\nFirst conversation:\n\n![FirstConversation.png](https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/78c48b8b-8a1b-4caf-ef23-2ad78be3a100/public)\n\nWhat GPT sent do the API:\n\n```json\n{\n \"name\": \"Life Essence and Biological Processes\",\n \"description\": \"Explore the role of life essence in enabling biological processes, with a focus on how dimensional interference, particularly from the Incorporeal dimension, facilitates the existence of these processes. This exploration should delve into the complex interplay between the Physical and Incorporeal dimensions, examining how life essence acts as a crucial element in the emergence and sustenance of life in the Physical dimension.\",\n \"summary\": \"Expanding on the role of life essence in biological processes, emphasizing the interaction between the Physical and Incorporeal dimensions.\",\n \"reason\": \"To deepen the understanding of how life essence, influenced by dimensional interference, is essential for biological processes in the novel's universe.\"\n}\n```\n\nSeparate conversation somewhere in the future:\n\n![Second Conversation.png](https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/bae24fd1-cec7-49b1-ac16-74b9f5aa4c00/public)\n\n# Setup\n\nThere are several steps to set up the API:\n- deploy and configure the API\n- create the API key for your GPT\n- add an action for the API in you GPT\n- add prompt section to your GPT so that it can use it properly\n\n## Deploying the API on Val Town\n\nDeploy your own memory API. You can fork the following Val to do it: https://www.val.town/v/xkonti/memoryApiExample\n\nIn the code configure the appropriate values:\n\n- `apiName` the name of your API - used in the Privacy Policy (eg. `Memory API`)\n- `contactEmail` - the email to provide for contact in the Privacy Policy (eg. `some@email.com`)\n- `lastPolicyUpdate` - the date the Privacy Policy was last updated (eg. `2023-11-28`)\n- `blobKeyPrefix` - the prefix for the blob storage keys used by your API - more info below (eg. `gpt:memories:`)\n- `apiKeyPrefix` - the prefix for you API Keys secrets - more info below (eg. `GPTMEMORYAPI_KEY_`)\n\n## Create API keys\n\nThe Memory API is designed to serve multiple GPTs at the same time. Each GPT should have it's own unique **name** and **API key**.\n\nThe **name** is used for identifying the specific GPT and appended to both:\n- `blobKeyPrefix`- to maintain separate memory storage from other GPTs\n- `apiKeyPrefix` - to maintain separate API key for each GPT\n\n1. Please pick a unique alphanumeric name for your GPT. For example `personaltrainer`.\n2. Generate some alphanumeric API key for your GPT. For example `Wrangle-Chapped-Monkhood4-Domain-Suspend`\n3. Add a new secret to your Val.town secrets storage. The Key should be the picked name prefixed by `apiKeyPrefix`. Using the default it would be `GPTMEMORYAPI_KEY_personaltrainer`. The value of the secret should be the API key itself.\n\nThe memories of the GPT will be stored in the blob storage under the key `blobKeyPrefix + name`, for example: `gpt:memories:personaltrainer`.\n\n## Adding GPT action\n\n1. Add a new action in your GPT.\n2. Get the OpenAPI spefication by calling the `/openapi` endpoint of your API\n3. Change all `` instances within the specification to the url of your deployed API. For example `https://xkonti-memoryapiexample.web.val.run`\n4. Set the authentication method to basic and provide a [base64 encoded](https://www.base64encode.org/) version of the `:`. For example: `personaltrainer:Wrangle-Chapped-Monkhood4-Domain-Suspend` -> `cGVyc29uYWx0cmFpbmVyOldyYW5nbGUtQ2hhcHBlZC1Nb25raG9vZDQtRG9tYWluLVN1c3BlbmQ=`\n5. Add the link to the privacy policy, which is the `/privacy` endpoint of your API. For example: `https://xkonti-memoryapiexample.web.val.run/privacy`\n\n## Adding the prompt section\n\nTo make your GPT understand the usage of your new action you should include usage instruction in your prompt. Here's an example of such instructions section:\n\n```md\n# Long-term memory\n\nAt some point the user might ask you to do something with \"memory\". Things like \"remember\", \"save to memory\", \"forget\", \"update memory\", etc. Please use corresponding actions to achieve those tasks. User might also ask you to perform some task with the context of your \"memory\" - in that case fetch all memories before proceeding with the task. The memories should be formed in a clear and purely informative language, void of unnecessary adjectives or decorative language forms. An exception to that rule might be a case when the language itself is the integral part of information (snippet of writing to remember for later, examples of some specific language forms, quotes, etc.).\n\nStructure of a memory:\n- name - a simple name of the memory to give it context at a glance\n- description - a detailed description of the thing that should be remembered. There is no length limit.\n- summary - a short summary of the memory. This should be formed in a way that will allow for ease of understanding which memories to retrieve in full detail just by reading the list of summaries. If there are some simple facts that have to be remembered and are the main point of the memory they should be included in the summary. The summary should also be written in a compressed way with all unnecessary words skipped if possible (more like a set of keywords or a Google Search input).\n- reason - the reason for the remembering - this should give extra information about the situation in which the memory was requested to be saved.\n\nThe memory accessed through those actions is a long-term memory persistent between various conversations with the user. You can assume that there already are many memories available for retrieval.\n\nIn some situations you might want to save some information to your memory for future recall. Do it in situations where you expect that some important details of the conversation might be lost and should be preserved.\n\nAnalogously you can retrieve memories at any point if the task at hand suggests the need or there isn't much information about the subject in your knowledge base.\n```",[144],"pulls","forks","envVars",{"_155":34,"_157":34},"connections",{"_155":34,"_156":34},"count","unfilledCount","emptyCount",{"_20":143,"_13":144,"_129":145,"_130":-5,"_131":21,"_132":54,"_133":40,"_22":164,"_29":34,"_136":105,"_138":147,"_140":77,"_141":-5,"_161":165,"_93":166},{"_20":127,"_13":128,"_129":49,"_130":-5,"_131":21,"_132":30,"_133":40,"_22":160,"_29":135,"_136":137,"_138":139,"_140":77,"_141":-5,"_161":162,"_93":163},["D",1744083774807],"children",[],[128],["D",1727017248599],[],[144],["D",1746128644024],{"_11":12,"_91":87},{"_11":12,"_85":-5,"_86":87,"_46":47,"_88":89,"_90":77},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":32,"_33":34,"_78":42,"_79":80,"_81":82,"_83":14,"_84":12},"ctx",{"_70":-5,"_115":204,"_205":206,"_207":208,"_209":77,"_210":77,"_211":77,"_212":40,"_213":-5,"_214":-7,"_215":-7,"_216":34,"_217":77,"_218":77,"_219":-5,"_220":77,"_221":77,"_222":77,"_223":-5},"ENV",{"_175":176,"_177":178,"_179":26,"_180":181,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193,"_194":195,"_196":197,"_198":199,"_200":201,"_202":203},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","811aa22498c9b0b5a47e8d778de579cdb990f332","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Memory API GUI

Add New Memory

Memories

{memory.name}

Branches1

Branches
1