Update README.md

README.md

@@ -9,5 +9,78 @@ app_file: app.py
 pinned: false
 license: mit
 ---
+# Nova Conversation Partner
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+A real-time, natural-sounding AI conversation partner powered by AWS NovaSonic.
+
+## Core Features
+
+- **Live, Natural-Sounding AI Conversation**: Nova acts as a friendly, responsive conversation partner.
+- **Low-Latency Real-Time Streaming**: Audio streams directly to NovaSonic's bidirectional API.
+- **Speech Coaching**: Analyzes speech patterns and subtly helps improve fluency.
+- **Session Memory**: Continues conversations from where they left off.
+- **Minimal UI**: Simple interface with just a Repeat button and status information.
+
+## Setup
+
+1. **Install Dependencies**:
+   ```
+   pip install -r requirements.txt
+   ```
+
+2. **AWS Credentials**:
+   Ensure you have AWS credentials configured with access to the Amazon Bedrock service.
+
+## Usage
+
+### UI Mode (Default)
+
+```
+python app.py
+```
+
+This launches a Gradio web interface with:
+- Start/Stop conversation buttons
+- Replay last message button
+- Status indicator
+
+### Command Line Mode
+
+```
+python app.py --cli
+```
+
+In CLI mode, the conversation runs in the terminal with:
+- Automatic audio recording/playback
+- Press Ctrl+C to exit
+
+### Resume a Session
+
+To continue a previous conversation:
+
+```
+python app.py --session SESSION_ID
+```
+
+Replace `SESSION_ID` with the ID of a previous session.
+
+## Configuration
+
+Edit `config.py` to customize:
+- Audio settings
+- Greeting message
+- Memory limit
+- UI text
+
+## Development
+
+The application architecture includes:
+- `nova_sonic.py`: AWS NovaSonic API client
+- `audio_utils.py`: Audio recording and playback
+- `language_coach.py`: Speech pattern analysis
+- `session_manager.py`: Conversation persistence
+- `app.py`: Main application logic
+
+## License
+
+MIT