diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000000000000000000000000000000000000..8adabf357fb0f496f0e407a91aca915e78deaded
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,22 @@
+# ChangeLog
+
+## [v0.0.1] - 2023-07-19
+Release Highlights:
+
+### Product releases and updates:
+- iOS App TestFlight public beta (link https://testflight.apple.com/join/JA6p9sZQ)
+- Rewrite Web codebase from vanilla JavaScript to use React framework w/ Javascript
+- Support Unicode in chat messages
+- Various UI refinements
+
+### Integration updates:
+- Support Azure OpenAI
+
+### Observability and quality updates:
+- Support Integration with LangSmith
+- Reduce Docker rebuild time to ~2 seconds
+- Support string based user ID
+- Support Session ID, Platform, Action Type in database records.
+
+### New Tutorial:
+[How to make your own AI character and run it locally](https://youtu.be/meg5Q8vdWeQ)
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000000000000000000000000000000000000..fd125f112d69fecf578ac31a3ceaf9b923e3e64a
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,22 @@
+FROM python:slim
+
+# Install system-level dependencies
+RUN apt-get update && apt-get install -y build-essential portaudio19-dev libffi-dev libssl-dev ffmpeg
+
+WORKDIR /realtime_ai_character
+
+# Install Python dependencies
+COPY requirements.txt /realtime_ai_character
+RUN pip install -r /realtime_ai_character/requirements.txt
+
+# Copy the project files
+COPY ./ /realtime_ai_character
+
+# Expose 7860 port from the docker image.
+EXPOSE 7860
+
+# Make the entrypoint script executable
+RUN chmod +x /realtime_ai_character/entrypoint.sh
+
+# Run the application
+CMD ["/bin/sh", "/realtime_ai_character/entrypoint.sh"]
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..bdd182b0d55165bd8b5ffa0f9e0de65c294fc49f
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 shaun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 279c07071033e31069b2a2af1e185087ac7872fa..f93d1331b59473448e8858605ee1f249a1c37aad 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,276 @@
----
-title: RealChar
-emoji: β‘
-colorFrom: pink
-colorTo: pink
-sdk: docker
-pinned: false
-license: mit
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# RealChar. - Your Realtime AI Character
+
+
+ ποΈπ€Create, customize and talk to your AI Character/Companion in realtimeποΈπ€ +
+ + + +## β¨ Demo +Try our site at [RealChar.ai](https://realchar.ai/) + +(We are also beta-testing our iOS mobile appπ±! Sign up [here](https://testflight.apple.com/join/JA6p9sZQ)) + +### Demo 1 - with AI Elon about cage fight! + +https://github.com/Shaunwei/RealChar/assets/5101573/5de0b023-6cf3-4947-84cb-596f429d109e + +### Demo 2 - with AI Raiden about AI and "real" memory + +https://github.com/Shaunwei/RealChar/assets/5101573/62a1f3d1-1166-4254-9119-97647be52c42 + + + +__Demo settings: Web, GPT4, ElevenLabs with voice clone, Chroma, Google Speech to Text__ + +## π― Key Features +- **Easy to use**: No coding required to create your own AI character. +- **Customizable**: You can customize your AI character's personality, background, and even voice +- **Realtime**: Talk to or message your AI character in realtime +- **Multi-Platform**: You can talk to your AI character on web, terminal and mobile(Yes. we open source our mobile app) +- **Most up-to-date AI**: We use the most up-to-date AI technology to power your AI character, including OpenAI, Anthropic Claude 2, Chroma, Whisper, ElevenLabs, etc. +- **Modular**: You can easily swap out different modules to customize your flow. Less opinionated, more flexible. Great project to start your AI Engineering journey. + +## π¬ Tech stack ++ Please wear headphone π§ + { isConnected.current && characterConfirmed && isRecording ? + (Recording) : null + } +
+ + { !isConnected.current ? +{headerText}
+ + { !isConnected.current ? + : null + } + + { isConnected.current && +This website is best viewed on a desktop browser.
+Please switch to a desktop for the best experience.
+Mobile version is coming soon!
+If you have an iOS device, you can test our iOS beta app.
+This website is best viewed on a desktop browser.
+Please switch to a desktop for the best experience.
+Mobile version is coming soon!
+If you have an iOS device, you can test our iOS beta app.
+Please wear headphone π§ Recording
+