expo-ai-core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 expo-ai-core contributors
+
+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.

package/README.md

@@ -0,0 +1,162 @@
+# expo-ai-core ⚡
+
+> Add AI (ChatGPT-style chat, streaming, voice) to your Expo app in **5 lines of code**
+
+---
+
+## 🚀 Why this exists
+
+Building AI features in Expo is painful:
+
+- Too much boilerplate
+- No streaming support
+- Voice is messy
+- UI takes forever
+
+**expo-ai-core fixes all of that.**
+
+---
+
+## ⚡ Quick Demo
+
+```tsx
+import { AIChatView, useAIChat } from "expo-ai-core";
+
+export default function Screen() {
+  const chat = useAIChat({
+    provider: "openai",
+    apiKey: "YOUR_API_KEY",
+  });
+
+  return <AIChatView {...chat} />;
+}
+```
+
+👉 That’s it. You now have a working AI chat UI.
+
+---
+
+## ✨ Features
+
+- 🧠 **AI Chat Hook** → `useAIChat`
+- ⚡ **Streaming Responses** (real-time typing effect)
+- 🎤 **Voice Input + TTS**
+- 🔌 **Multi-Provider Support**
+  - OpenAI
+  - Google Gemini
+
+- 💬 **Prebuilt UI Components**
+- 💾 **Offline Cache + Persistence**
+- ⚙️ **Zero Backend Required**
+- 📦 **Tiny & Tree-shakable**
+
+---
+
+## 📦 Installation
+
+```bash
+npm install expo-ai-core
+npm install expo-speech expo-av @react-native-async-storage/async-storage
+```
+
+---
+
+## 🔧 Providers
+
+### OpenAI
+
+```tsx
+useAIChat({
+  provider: "openai",
+  apiKey: process.env.EXPO_PUBLIC_OPENAI_API_KEY!,
+  model: "gpt-4o-mini",
+});
+```
+
+### Gemini
+
+```tsx
+useAIChat({
+  provider: "gemini",
+  apiKey: process.env.EXPO_PUBLIC_GEMINI_API_KEY!,
+  model: "gemini-2.5-flash",
+});
+```
+
+---
+
+## 🎤 Voice (Speech-to-Text + TTS)
+
+```tsx
+import { useAIVoice } from "expo-ai-core";
+
+const voice = useAIVoice();
+
+await voice.startListening();
+await voice.stopListening();
+await voice.speak("Hello from Expo");
+```
+
+---
+
+## 🧩 Components
+
+- `AIChatView` → full chat UI
+- `AIInput` → input box
+- `AIMessageBubble` → messages
+- `AITypingIndicator` → streaming state
+
+All components are:
+
+- Customizable
+- NativeWind-compatible
+- Lightweight
+
+---
+
+## 🧠 How it works
+
+- Uses `fetch` (no backend needed)
+- Streams tokens in real-time
+- Stores chats via AsyncStorage
+- Works in Expo Go
+
+---
+
+## ⚠️ Notes
+
+- Native speech recognition requires platform support
+- Works best with Expo SDK 50+
+- No Node.js APIs used
+
+---
+
+## 📱 Example App
+
+See `/example` for a full working demo.
+
+---
+
+## 💡 Coming Soon
+
+- Image generation support
+- Markdown + code block rendering
+- Better voice transcription
+- More providers
+
+---
+
+## ⭐ Support
+
+If this helped you:
+
+- Star the repo ⭐
+- Share on Twitter/X
+- Build something cool 🚀
+
+---
+
+## 🧑‍💻 Author
+
+Built by Arhan Ansari
+[Twitter](https://twitter.com/codewitharhan) | [GitHub](https://github.com/ArhanAnsari)