@photon-cli/flux 0.3.0 → 0.3.2

package/README.md

@@ -51,13 +51,169 @@ bun add @photon-cli/flux
 
 ---
 
+## Flux Number
+
+Message +16286298650 with you phone number to text the LangChain agent that you built. 
+
+---
+
+## Usage 
+
+#### Step 1: Create LangChain Agent
+
+Create agent.ts file with your LangChain agent: 
+
+```
+// agent.ts
+export default {
+  async invoke({ message }: { message: string }) {
+    return `You said: ${message}`;
+  }
+};
+```
+
+### Step 2: Login
+
+Authenticate with your phone number and iMessage: 
+
+```
+npx @photon-cli/flux login
+
+Enter your phone number (e.g. +15551234567): +1234567890
+[FLUX] Validating with server...
+[FLUX] Logged in as +1234567890
+```
+
+### Step 3: Validate
+
+Validate that your agent works and exports correctly: 
+
+```
+npx @photon-cli/flux validate
+
+[FLUX] Validating agent.ts...
+[FLUX] Agent is valid!
+```
+
+### Step 4: Testing Mode
+
+Test your agent through your terminal (no iMessage connection): 
+
+```
+npx @photon-cli/flux run --local
+
+[FLUX] Welcome to Flux! Your agent is loaded.
+[FLUX] Type a message to test it. Press Ctrl+C to exit.
+
+You: Hello!
+[FLUX] Thinking...
+Agent: Hello! How can I assist you today?
+```
+
+### Step 5: Live Connection
+
+Run your agent locally and connect it to the iMessage bridge. When you message the FLUX number with your phone number, you will receive the output of your LangChain agent: 
+
+```
+npx @photon-cli/flux run --prod
+
+[FLUX] Loading agent from agent.ts...
+[FLUX] Agent loaded successfully!
+[FLUX] Connected to server at fluxy.photon.codes:443
+[FLUX] Registered agent for +1234567890
+[FLUX] Agent running in production mode. Press Ctrl+C to stop.
+[FLUX] Messages to +1234567890 will be processed by your agent.
+
+```
+
+---
+
 ## Why Flux
 
+Right now, connecting agents to messaging platforms involves complex processes such as setting up servers, configuring webhooks, and dealing with platform APIs. Furthermore, most current options use SMS or WhatsApp, which is unintuitive for many users. 
+
+Flux solves these problems in the following ways: 
+
+- **Deploy in < 5 seconds**: Link your LangChain agent to iMessage with a single command.
+- **Fully iMessage native**: Direct iMessage integration, not SMS or WhatsApp. 
+- **Zero Infrastructure**: No servers to manage, webhooks to configure, or Apple Developer account needed. 
+- **Open source**: Fully community driven.
+- **Free to use**: No subscription fees.
+
 ---
 
 ## Examples
 
+### Echo Bot (No LLM)
+
+```
+// agent.ts
+export default {
+  async invoke({ message }: { message: string }) {
+    return `You said: ${message}`;
+  }
+};
+```
+
+### ChatGPT Bot
 
+```
+// agent.ts
+import { ChatOpenAI } from "@langchain/openai";
+import { SystemMessage, HumanMessage } from "@langchain/core/messages";
+
+const llm = new ChatOpenAI({ modelName: "gpt-4o-mini" });
+
+export default {
+  async invoke({ message }: { message: string }) {
+    const response = await llm.invoke([
+      new SystemMessage("You are a helpful assistant. Be concise."),
+      new HumanMessage(message),
+    ]);
+    return response.content as string;
+  }
+};
+```
+
+### Chatbot with tools
+
+```
+// agent.ts
+import { ChatOpenAI } from "@langchain/openai";
+import { tool } from "@langchain/core/tools";
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+import { z } from "zod";
+
+const calculator = tool(
+  async ({ expression }: { expression: string }) => {
+    return String(eval(expression));
+  },
+  {
+    name: "calculator",
+    description: "Evaluate a math expression",
+    schema: z.object({ expression: z.string() }),
+  }
+);
+
+const getTime = tool(
+  async () => new Date().toLocaleTimeString(),
+  {
+    name: "get_time",
+    description: "Get the current time",
+    schema: z.object({}),
+  }
+);
+
+const llm = new ChatOpenAI({ modelName: "gpt-4o-mini" });
+const agent = createReactAgent({ llm, tools: [calculator, getTime] });
+
+export default {
+  async invoke({ message }: { message: string }) {
+    const result = await agent.invoke({ messages: [{ role: "user", content: message }] });
+    return result.messages[result.messages.length - 1].content as string;
+  }
+};
+```
 
 ---