agentkit-sdk 0.1.0__tar.gz

agentkit_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: agentkit-sdk
+Version: 0.1.0
+Summary: Developer SDK for building personalized voice AI assistants
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Requires-Dist: websockets>=14.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: pydantic-settings>=2.6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: google-generativeai>=0.8.0
+Requires-Dist: openai>=1.50.0
+Requires-Dist: qdrant-client>=1.12.0
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: tiktoken>=0.7.0
+Requires-Dist: aiofiles>=24.0.0
+Requires-Dist: tenacity>=9.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: mypy>=1.13.0; extra == "dev"
+
+# AgentKit
+
+Developer SDK for building personalized voice AI assistants with mobile APK generation.
+
+## Quick Start
+
+```bash
+# Install
+pip install agentkit
+
+# Initialize a new agent project
+agentkit init my-agent
+
+# Add API keys to .env
+cd my-agent
+cp .env.example .env
+
+# Start the server
+agentkit serve
+```
+
+## Configuration
+
+Edit `agent.config.yaml`:
+
+```yaml
+agent:
+  name: "Assistant"
+  persona: "You are a helpful personal assistant..."
+  language: hinglish
+
+voice:
+  stt:
+    provider: sarvam  # or deepgram
+    api_key: ${SARVAM_API_KEY}
+  tts:
+    provider: sarvam  # or elevenlabs
+    voice: "meera"
+    api_key: ${SARVAM_API_KEY}
+
+llm:
+  provider: gemini  # or openai
+  model: gemini-2.0-flash
+  api_key: ${GEMINI_API_KEY}
+  temperature: 0.7
+
+memory:
+  type: markdown  # or vector
+  backend: local  # or qdrant
+
+learning:
+  enabled: true
+  correction_detection: true
+  implicit_feedback: true
+```
+
+## Commands
+
+- `agentkit init` - Initialize a new project
+- `agentkit serve` - Start the FastAPI server
+- `agentkit build android` - Build Android APK
+- `agentkit deploy --platform railway` - Deploy to Railway or Render
+
+## Architecture
+
+- **CLI** - Python Click commands for init, serve, build, deploy
+- **Pipeline** - Streaming STT → LLM → TTS orchestration with <500ms latency
+- **Memory** - Markdown (MVP) or Qdrant vector storage with semantic retrieval
+- **Learning** - Explicit/implicit correction detection, proactive recommendations
+- **Mobile** - React Native + Expo VoiceOrb interface
+
+## Environment Variables
+
+```
+SARVAM_API_KEY=your_sarvam_key
+GEMINI_API_KEY=your_gemini_key
+DEEPGRAM_API_KEY=your_deepgram_key
+ELEVENLABS_API_KEY=your_elevenlabs_key
+OPENAI_API_KEY=your_openai_key
+```

agentkit_sdk-0.1.0/README.md

@@ -0,0 +1,80 @@
+# AgentKit
+
+Developer SDK for building personalized voice AI assistants with mobile APK generation.
+
+## Quick Start
+
+```bash
+# Install
+pip install agentkit
+
+# Initialize a new agent project
+agentkit init my-agent
+
+# Add API keys to .env
+cd my-agent
+cp .env.example .env
+
+# Start the server
+agentkit serve
+```
+
+## Configuration
+
+Edit `agent.config.yaml`:
+
+```yaml
+agent:
+  name: "Assistant"
+  persona: "You are a helpful personal assistant..."
+  language: hinglish
+
+voice:
+  stt:
+    provider: sarvam  # or deepgram
+    api_key: ${SARVAM_API_KEY}
+  tts:
+    provider: sarvam  # or elevenlabs
+    voice: "meera"
+    api_key: ${SARVAM_API_KEY}
+
+llm:
+  provider: gemini  # or openai
+  model: gemini-2.0-flash
+  api_key: ${GEMINI_API_KEY}
+  temperature: 0.7
+
+memory:
+  type: markdown  # or vector
+  backend: local  # or qdrant
+
+learning:
+  enabled: true
+  correction_detection: true
+  implicit_feedback: true
+```
+
+## Commands
+
+- `agentkit init` - Initialize a new project
+- `agentkit serve` - Start the FastAPI server
+- `agentkit build android` - Build Android APK
+- `agentkit deploy --platform railway` - Deploy to Railway or Render
+
+## Architecture
+
+- **CLI** - Python Click commands for init, serve, build, deploy
+- **Pipeline** - Streaming STT → LLM → TTS orchestration with <500ms latency
+- **Memory** - Markdown (MVP) or Qdrant vector storage with semantic retrieval
+- **Learning** - Explicit/implicit correction detection, proactive recommendations
+- **Mobile** - React Native + Expo VoiceOrb interface
+
+## Environment Variables
+
+```
+SARVAM_API_KEY=your_sarvam_key
+GEMINI_API_KEY=your_gemini_key
+DEEPGRAM_API_KEY=your_deepgram_key
+ELEVENLABS_API_KEY=your_elevenlabs_key
+OPENAI_API_KEY=your_openai_key
+```

agentkit_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentkit-sdk"
+version = "0.1.0"
+description = "Developer SDK for building personalized voice AI assistants"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "websockets>=14.0",
+    "pydantic>=2.10.0",
+    "pydantic-settings>=2.6.0",
+    "python-dotenv>=1.0.0",
+    "pyyaml>=6.0.0",
+    "click>=8.1.0",
+    "httpx>=0.27.0",
+    "google-generativeai>=0.8.0",
+    "openai>=1.50.0",
+    "qdrant-client>=1.12.0",
+    "numpy>=1.26.0",
+    "tiktoken>=0.7.0",
+    "aiofiles>=24.0.0",
+    "tenacity>=9.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "ruff>=0.8.0",
+    "mypy>=1.13.0",
+]
+
+[project.scripts]
+agentkit = "agentkit.cli.main:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["agentkit", "agentkit.cli", "agentkit.core", "agentkit.memory", "agentkit.learning", "agentkit.providers.*", "agentkit.server"]
+
+[tool.ruff]
+target-version = "py311"
+
+[tool.mypy]
+python-version = "3.11"

agentkit_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agentkit_sdk-0.1.0/src/agentkit/__init__.py

@@ -0,0 +1,3 @@
+"""AgentKit - Developer SDK for building personalized voice AI assistants"""
+
+__version__ = "0.1.0"

agentkit_sdk-0.1.0/src/agentkit/cli/build.py

@@ -0,0 +1,54 @@
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+import click
+
+
+@click.command()
+@click.option("--config", default="agent.config.yaml", help="Config file path")
+@click.option("--output", default="build/", help="Output directory")
+def android(config: str, output: str):
+    """Build Android APK from AgentShell template."""
+    
+    if not Path(config).exists():
+        click.echo(f"Error: Config file '{config}' not found.")
+        sys.exit(1)
+    
+    click.echo("Building Android APK...")
+    
+    import yaml
+    with open(config) as f:
+        cfg = yaml.safe_load(f)
+    
+    agent_name = cfg.get("agent", {}).get("name", "Agent")
+    backend_url = cfg.get("deployment", {}).get("backend_url", "ws://localhost:8000/ws/voice")
+    
+    template_dir = Path(__file__).parent.parent / "mobile" / "AgentShell"
+    
+    if not template_dir.exists():
+        click.echo("Error: AgentShell template not found.")
+        sys.exit(1)
+    
+    project_dir = Path(output)
+    project_dir.mkdir(parents=True, exist_ok=True)
+    
+    shutil.copytree(template_dir, project_dir / "AgentShell", dirs_exist_ok=True)
+    
+    app_js = project_dir / "AgentShell" / "App.jsx"
+    if app_js.exists():
+        content = app_js.read_text()
+        content = content.replace("ws://localhost:8000/ws/voice", backend_url)
+        content = content.replace("Assistant", agent_name)
+        app_js.write_text(content)
+    
+    click.echo("Installing dependencies...")
+    os.chdir(project_dir / "AgentShell")
+    subprocess.run(["npm", "install"], check=True)
+    
+    click.echo("Building Android APK...")
+    subprocess.run(["npx", "expo", "run:android"], check=True)
+    
+    click.echo(f"APK built at: {project_dir / "AgentShell/android/app/build/outputs/apk/release/"}")

agentkit_sdk-0.1.0/src/agentkit/cli/deploy.py

@@ -0,0 +1,50 @@
+import subprocess
+import sys
+
+import click
+
+
+PLATFORMS = ["railway", "render"]
+
+
+@click.command()
+@click.option("--platform", type=click.Choice(PLATFORMS), required=True, help="Deployment platform")
+@click.option("--config", default="agent.config.yaml", help="Config file path")
+def deploy(platform: str, config: str):
+    """Deploy backend to Railway or Render."""
+    
+    click.echo(f"Deploying to {platform}...")
+    
+    if platform == "railway":
+        _deploy_railway()
+    elif platform == "render":
+        _deploy_render()
+
+
+def _deploy_railway():
+    try:
+        result = subprocess.run(["railway", "login"], capture_output=True)
+        if result.returncode != 0:
+            click.echo("Please install Railway CLI: npm install -g @railway/cli")
+            sys.exit(1)
+        
+        subprocess.run(["railway", "init"], check=True)
+        subprocess.run(["railway", "up"], check=True)
+        
+        click.echo("Deployed to Railway! Run 'railway link' to connect.")
+    except FileNotFoundError:
+        click.echo("Railway CLI not found. Install with: npm install -g @railway/cli")
+
+
+def _deploy_render():
+    try:
+        result = subprocess.run(["render", "--version"], capture_output=True)
+        if result.returncode != 0:
+            click.echo("Please install Render CLI: npm install -g render-cli")
+            sys.exit(1)
+        
+        subprocess.run(["render", "blueprint", "init"], check=True)
+        
+        click.echo("Deployed to Render! Check your dashboard for the live URL.")
+    except FileNotFoundError:
+        click.echo("Render CLI not found. Install with: npm install -g render-cli")

agentkit_sdk-0.1.0/src/agentkit/cli/init.py

@@ -0,0 +1,85 @@
+import os
+import shutil
+from pathlib import Path
+
+import click
+import yaml
+
+
+@click.command()
+@click.option("--name", default="my-agent", help="Agent name")
+@click.option("--output-dir", default=".", help="Output directory")
+def init(name: str, output_dir: str):
+    """Initialize a new AgentKit project."""
+    
+    project_dir = Path(output_dir) / name
+    project_dir.mkdir(parents=True, exist_ok=True)
+    
+    config_content = {
+        "agent": {
+            "name": name,
+            "persona": "You are a helpful personal assistant that remembers conversations and learns from corrections.",
+            "language": "hinglish"
+        },
+        "voice": {
+            "enabled": True,
+            "stt": {
+                "provider": "sarvam",
+                "api_key": "${SARVAM_API_KEY}"
+            },
+            "tts": {
+                "provider": "sarvam",
+                "voice": "meera",
+                "api_key": "${SARVAM_API_KEY}"
+            }
+        },
+        "llm": {
+            "provider": "gemini",
+            "model": "gemini-2.0-flash",
+            "api_key": "${GEMINI_API_KEY}",
+            "temperature": 0.7
+        },
+        "memory": {
+            "type": "markdown",
+            "backend": "local",
+            "episodic_window": 20,
+            "semantic_top_k": 5
+        },
+        "learning": {
+            "enabled": True,
+            "correction_detection": True,
+            "implicit_feedback": True,
+            "profile_extraction": True
+        },
+        "deployment": {
+            "type": "self-host",
+            "port": 8000
+        }
+    }
+    
+    config_path = project_dir / "agent.config.yaml"
+    with open(config_path, "w") as f:
+        yaml.dump(config_content, f, default_flow_style=False)
+    
+    env_example = """# API Keys
+SARVAM_API_KEY=your_sarvam_key
+GEMINI_API_KEY=your_gemini_key
+DEEPGRAM_API_KEY=your_deepgram_key
+ELEVENLABS_API_KEY=your_elevenlabs_key
+OPENAI_API_KEY=your_openai_key
+"""
+    
+    env_path = project_dir / ".env.example"
+    with open(env_path, "w") as f:
+        f.write(env_example)
+    
+    src_dir = project_dir / "src"
+    src_dir.mkdir(exist_ok=True)
+    
+    (src_dir / "__init__.py").touch()
+    
+    click.echo(f"AgentKit project '{name}' created at {project_dir}")
+    click.echo(f"Next steps:")
+    click.echo(f"  1. cd {project_dir}")
+    click.echo(f"  2. cp .env.example .env and add your API keys")
+    click.echo(f"  3. agentkit serve")

agentkit_sdk-0.1.0/src/agentkit/cli/main.py

@@ -0,0 +1,22 @@
+import click
+
+from agentkit.cli.init import init
+from agentkit.cli.serve import serve
+from agentkit.cli.build import android
+from agentkit.cli.deploy import deploy
+
+
+@click.group()
+def cli():
+    """AgentKit - Build personalized voice AI assistants"""
+    pass
+
+
+cli.add_command(init)
+cli.add_command(serve)
+cli.add_command(android)
+cli.add_command(deploy)
+
+
+if __name__ == "__main__":
+    cli()

agentkit_sdk-0.1.0/src/agentkit/cli/serve.py

@@ -0,0 +1,35 @@
+import os
+import sys
+from pathlib import Path
+
+import click
+from dotenv import load_dotenv
+
+
+@click.command()
+@click.option("--config", default="agent.config.yaml", help="Config file path")
+@click.option("--port", default=8000, help="Server port")
+@click.option("--reload", is_flag=True, help="Enable auto-reload")
+def serve(config: str, port: int, reload: bool):
+    """Start the AgentKit server."""
+    
+    if not Path(config).exists():
+        click.echo(f"Error: Config file '{config}' not found.")
+        click.echo("Run 'agentkit init' first to create a project.")
+        sys.exit(1)
+    
+    load_dotenv()
+    
+    import uvicorn
+    from agentkit.server.app import app
+    
+    click.echo(f"Starting AgentKit server on port {port}...")
+    click.echo(f"Playground available at http://localhost:{port}/playground")
+    
+    uvicorn.run(
+        "agentkit.server.app:app",
+        host="0.0.0.0",
+        port=port,
+        reload=reload,
+        env_file=".env",
+    )

agentkit_sdk-0.1.0/src/agentkit/core/__init__.py

@@ -0,0 +1,3 @@
+from .pipeline import VoicePipeline, PipelineConfig, Turn
+from .context import ContextAssembler, MemoryContext
+from .turn_detector import TurnDetector

agentkit_sdk-0.1.0/src/agentkit/core/context.py

@@ -0,0 +1,75 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class MemoryContext:
+    user_profile_summary: str = ""
+    semantic_episodes: str = ""
+    correction_rules: str = ""
+    recent_turns: str = ""
+
+    def assemble(self) -> str:
+        parts = []
+        if self.user_profile_summary:
+            parts.append(f"User Profile:\n{self.user_profile_summary}")
+        if self.semantic_episodes:
+            parts.append(f"Relevant History:\n{self.semantic_episodes}")
+        if self.correction_rules:
+            parts.append(f"Correction Rules:\n{self.correction_rules}")
+        if self.recent_turns:
+            parts.append(f"Recent Conversation:\n{self.recent_turns}")
+        return "\n\n".join(parts)
+
+
+class ContextAssembler:
+    def __init__(self, memory):
+        self.memory = memory
+
+    async def assemble(self, query: str, user_id: str) -> MemoryContext:
+        context = MemoryContext()
+        
+        user_model = await self.memory.get_user_model(user_id)
+        if user_model:
+            context.user_profile_summary = self._summarize_user_model(user_model)
+        
+        semantic_results = await self.memory.retrieve(query, user_id)
+        if semantic_results:
+            context.semantic_episodes = self._format_semantic_results(semantic_results)
+        
+        if user_model and user_model.correction_rules:
+            context.correction_rules = self._format_corrections(user_model.correction_rules)
+        
+        recent_turns = await self.memory.get_recent_turns(user_id, limit=20)
+        if recent_turns:
+            context.recent_turns = self._format_recent_turns(recent_turns)
+        
+        return context
+
+    def _summarize_user_model(self, user_model) -> str:
+        parts = [f"Name: {user_model.name}"]
+        if user_model.communication_style:
+            parts.append(f"Style: {user_model.communication_style}")
+        if user_model.inferred_interests:
+            parts.append(f"Interests: {', '.join(user_model.inferred_interests[:5])}")
+        if user_model.stated_goals:
+            parts.append(f"Goals: {', '.join(user_model.stated_goals[:3])}")
+        return "\n".join(parts)
+
+    def _format_semantic_results(self, results: list) -> str:
+        formatted = []
+        for r in results[:5]:
+            formatted.append(f"- {r.get('content', '')[:200]}")
+        return "\n".join(formatted)
+
+    def _format_corrections(self, corrections: list) -> str:
+        formatted = []
+        for c in corrections[:10]:
+            formatted.append(f"- {c.get('rule', '')}")
+        return "\n".join(formatted)
+
+    def _format_recent_turns(self, turns: list) -> str:
+        formatted = []
+        for turn in turns:
+            formatted.append(f"User: {turn.get('user_message', '')}")
+            formatted.append(f"Assistant: {turn.get('assistant_message', '')}")
+        return "\n".join(formatted[-40:])