README.md

metadata

title: Scribe (Agent Docx Tool)
emoji: 🐠
colorFrom: purple
colorTo: red
sdk: gradio
sdk_version: 6.0.0
app_file: app.py
pinned: false
short_description: chat with multiple AI providers and export the conversation
tags:
  - mcp-in-action-track-enterprise
  - mcp-in-action-track-consumer
  - mcp-in-action-track-creative
  - mcp
  - word
  - document
  - writer
  - mcp-1st-birthday
  - hackathon

Scribe (Agent Docx Tool)

Project for the MCP 1st Birthday Hackathon that lets you chat with multiple AI providers and export the conversation to a .docx file.

Demo Video

➡️ Watch/Download: Sccribe_Agent.mp4

Share Post

Check out the project post and share it:

• https://www.linkedin.com/posts/oscar-felipe-gonz%C3%A1lez-gonz%C3%A1lez-019971387_mcphackathon-ai-opensource-activity-7400832821528936449-XxK1

Features

• Gradio web UI.
• Providers supported: OpenAI, Gemini, SambaNova, Nebius, and Ollama.
• Export full conversation to DOCX.
• Runs as MCP server (mcp_server=True) for integrations.
• Goal: help competitors use sponsor credits on their own accounts and tests during the hackathon.

Sponsors 🤝

Special thanks to MCP 1st Birthday Hackathon sponsors:

• OpenAI ✨
• Google Gemini 🌟
• SambaNova 🚀
• Nebius ⚡

Google Gemini SambaNova Nebius

Requirements

• Python 3.10+
• Dependencies in requirements.txt.

Installation

1. Create and activate a virtual environment:
   • Windows:
     • python -m venv .venv
     • .venv\Scripts\activate
   • Linux/Mac:
     • python -m venv .venv
     • source .venv/bin/activate
2. Install dependencies:
   • pip install -r requirements.txt

Provider Configuration

• OpenAI: API Key (sk-...) and model (e.g., gpt-4o).
• Gemini: API Key and model (e.g., gemini-1.5-flash).
• SambaNova: install sambanova, API Key, and model (leave empty for default Meta-Llama-3.1-8B-Instruct).
• Nebius: API Key and model (e.g., openai/gpt-oss-120b).
• Ollama: no API Key required; leave model empty for automatic local selection.

Usage

1. Run the app:
   • python app.py
2. In the UI:
   • Select a provider.
   • Enter API Key and model when applicable.
   • Type your message and press “Send”.
   • Press “Download Scribe .docx” to export the conversation.
3. The generated file will appear in the download component.

Structure

• app.py: UI and chat/export logic.
• requirements.txt: project dependencies.
• README.md: project documentation.

License

Apache 2.0