Samantha OS¹ (Her)

Samantha is an AI assistant inspired by the movie Her. This project is built to provide real-time voice interactions using the Realtime API and Chainlit. Samantha acts as an agent that calls various tools to handle user requests, such as querying stock prices, executing SQL commands, generating images, and creating Python scripts.

YouTube Demo

Watch a 2-minute demonstration of Samantha in action, where I showcase real-time voice interactions and various capabilities of the AI assistant.

Setup and Running

You can run Samantha either by setting up a virtual environment using uv or using Docker Compose. Note that setting up the environment variables is required in all cases.

Option 1: Using Virtual Environment

1. Clone the Repository

   git clone https://github.com/jesuscopado/samantha-os1.git
   cd samantha-os1
   

2. Set Up Virtual Environment

   • Install uv package manager: Installation Instructions
   • Create the virtual environment:

     uv sync
     

   • Activate the virtual environment:

     source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
     

3. Environment Variables

   • Create a .env file in the root directory by copying .env.example and updating it with your own keys.

4. Run the Application