diff --git a/README.md b/README.md index 907212b..1bdeff2 100644 --- a/README.md +++ b/README.md @@ -2,11 +2,22 @@ ### BIDARA is a GPT-4 chatbot that was instructed to help scientists and engineers understand, learn from, and emulate the strategies used by living things to create sustainable designs and technologies. -:rocket: **[Try it out](https://nasa-petal.github.io/bidara-deep-chat/)** - BIDARA can guide users through the Biomimicry Institute’s [Design Process](https://toolbox.biomimicry.org/methods/process/), a step-by-step method to propose biomimetic solutions to challenges. This process includes defining the problem, biologizing the challenge, discovering natural models, abstracting design strategies, and emulating nature's lessons. -`bidara-deep-chat` uses [a web interface](https://github.com/OvidijusParsiunas/deep-chat) to connect to BIDARA over the OpenAI Assistants API. To use it, you need to register for [an OpenAI API key](https://platform.openai.com/account/api-keys) first. All messages are sent directly from your web browser to OpenAI and back. +## :rocket: How to access + +1. [Create an OpenAI account](https://platform.openai.com/signup) +2. [Login to OpenAI Platform](https://platform.openai.com/login) +3. In the left sidebar, navigate to [Settings -> Billing](https://platform.openai.com/account/billing/overview) +4. Click the 'Add payment details' button +5. Add a minimum of $5 in credits. It is required to spend a minimum of $5 to [access GPT-4](https://platform.openai.com/docs/guides/rate-limits/usage-tiers?context=tier-free). +6. In the left sidebar, navigate to [API Keys](https://platform.openai.com/api-keys) +7. Verify your phone number, then click the 'Create new secret key' button. +8. Copy your secret key. +9. **[Open the BIDARA website](https://nasa-petal.github.io/bidara-deep-chat/)**, and paste your key into the input field. Your browser will save the key, so you only have to enter it once. + +- With OpenAI API you only pay for what you use. Track your usage and costs on the [Usage page](https://platform.openai.com/usage). +- After you send your first message to BIDARA, it will also be available to interact with through the [OpenAI Assistants Playground](https://platform.openai.com/assistants). This interface is more complex, but also provides more customizability. Just select BIDARA, then click the 'Test' button. ## :fire: Features enabled @@ -16,7 +27,7 @@ BIDARA can guide users through the Biomimicry Institute’s [Design Process](htt ## :computer: For developers -Uses Svelte and [deep-chat](https://github.com/OvidijusParsiunas/deep-chat) +`bidara-deep-chat` uses Svelte and [the deep-chat web component](https://github.com/OvidijusParsiunas/deep-chat) to connect to BIDARA over the OpenAI Assistants API. Template based on https://github.com/sveltejs/template ### Run locally @@ -55,4 +66,4 @@ npm run dev - get all messages using openai API. Then BIDARA can use the list of messages to summarize the conversation, or save the conversation history to PDF. -- get all code interpreter code. useful to check its work. \ No newline at end of file +- get all code interpreter code. useful to check its work.