cycls 0.0.2.22__py3-none-any.whl → 0.0.2.24__py3-none-any.whl

cycls/cycls.py

@@ -10,7 +10,7 @@ import inspect
 import logging
 logging.basicConfig(level=logging.ERROR)
 
-O = lambda x,y: print(f"✦/✧ {str(x).ljust(11)} | {y}")
+O = lambda x,y: print(f"✦/✧ {str(x).ljust(12)} | {y}")
 
 import os
 current_dir = os.path.dirname(os.path.abspath(__file__))
@@ -32,6 +32,7 @@ def find_available_port(start_port):
             port += 1
 
 import asyncssh, asyncio
+# ssh -q -i tuns -o StrictHostKeyChecking=no -R 80:localhost:9000 tuns.sh
 async def create_ssh_tunnel(x,y,z='tuns.sh'):
     try:
         async with asyncssh.connect(z,client_keys=[key_path],known_hosts=None) as conn:
@@ -42,30 +43,32 @@ async def create_ssh_tunnel(x,y,z='tuns.sh'):
     except (OSError, asyncssh.Error) as e:
         O("tunnel",f"disconnected ({e})")
 
-def register(handles, net, url, email):
+def register(handles, net, api_key):
     try:
         with httpx.Client() as client:
-            response = client.post(f"{net}/register", json={"handles":handles, "url":url, "email":email})
+            response = client.post(f"{net}/register", json={"handles":handles, "net":net, "api_key":api_key})
+            data = response.json()
             if response.status_code==200:
-                data = (response.json()).get("content")
                 for i in data:
-                    O(i[0],f"{net}/{i[1]}")
+                    O(f"{i['status']}/{i['mode']}", f"{net}/{i['handle']}" if i["status"] != "taken" else "")
+                return True
             else:
-                print("✦/✧ failed to register ⚠️")
+                O("failed", data.get("error"))
+                return False
     except Exception as e:
-        print(f"An error occurred: {e}")
+        O("error",e)
+        return False
 
 class Cycls:
-    def __init__(self, url="", net="https://cycls.com", port=find_available_port(8001), email=None):
+    def __init__(self, url="", net="https://cycls.com", port=find_available_port(8001), api_key=None):
         import uuid
-        self.subdomain = str(uuid.uuid4())[:8]
+        self.subdomain = str(uuid.uuid4())[:8] #!
         self.server = FastAPI()
         self.net = net
         self.port = port
         self.url = url
         self.apps = {}
-        self.prod = False
-        self.email = email
+        self.api_key = api_key
 
     def __call__(self, handle):
         def decorator(func):
@@ -76,13 +79,7 @@ class Cycls:
             def sync_wrapper(*args, **kwargs):
                 return StreamingResponse(func(*args, **kwargs))
             wrapper = async_wrapper if inspect.iscoroutinefunction(func) else sync_wrapper
-
-            if self.url != "": self.prod=True #!
-            if not self.prod:
-                self.apps[handle + "-dev"] = wrapper
-            else:
-                self.apps[handle] = wrapper
-
+            self.apps[handle] = wrapper
             return wrapper
         return decorator
     
@@ -96,29 +93,24 @@ class Cycls:
         return {"error": "Handle not found"}
 
     def push(self):
-        if self.email:
-            O("email",self.email)
         O("port",self.port)
-        if self.prod:
-            O("mode",f"production @ {self.url}")
-            register(list(self.apps.keys()), self.net, self.url+"/gateway", self.email)
+        if self.url=="":
+            # self.url = f"https://{self.subdomain}-cycls.tuns.sh"
+            self.url = f"https://cycls-{self.subdomain}.tuns.sh"
+            mode = "dev"
         else:
-            self.url = f"http://{self.subdomain}-cycls.tuns.sh"
-            O("mode","development")
-            O("docs","for more information, visit https://github.com/Cycls/cycls-py")
-            register(list(self.apps.keys()), self.net, self.url+"/gateway", self.email)
-
-        self.server.post("/gateway")(self.gateway)
-        @self.server.on_event("startup")
-        def startup_event():
-            if self.prod:
-                pass
-            else:
-                asyncio.create_task(create_ssh_tunnel(f"{self.subdomain}-cycls", self.port))
-        try:
-            uvicorn.run(self.server, host="127.0.0.1", port=self.port, log_level="error")
-        except KeyboardInterrupt:
-            print(" ");O("exit","done")
+            mode = "prod"
+        config = [{"handle": handle, "url": self.url+"/gateway", "mode":mode} for handle in list(self.apps.keys())]
+        if on := register(config, self.net, self.api_key):
+            self.server.post("/gateway")(self.gateway)
+            @self.server.on_event("startup")
+            def startup_event():
+                # asyncio.create_task(create_ssh_tunnel(f"{self.subdomain}-cycls", self.port))
+                asyncio.create_task(create_ssh_tunnel(f"{self.subdomain}", self.port))
+            try:
+                uvicorn.run(self.server, host="127.0.0.1", port=self.port, log_level="error")
+            except KeyboardInterrupt:
+                print(" ");O("exit","done")
 
     async def call(self, handle, content):
         data = {"handle":handle, "content":content, "session":{}, "agent":"yes"}

cycls-0.0.2.24.dist-info/METADATA

@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: cycls
+Version: 0.0.2.24
+Summary: Cycls SDK
+Author: Mohammed Jamal
+Author-email: mj@cycls.com
+Requires-Python: >=3.8,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: asyncssh (>=2.14.2,<3.0.0)
+Requires-Dist: fastapi (>=0.111.0,<0.112.0)
+Requires-Dist: httpx (>=0.27.0,<0.28.0)
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/96bd304d-8116-4bce-8b8f-b08980875ad7" width="800px" alt="Cycls Banner">
+</p>
+
+<h3 align="center">
+Generate live apps from code in minutes with built-in memory, <br/>rich hypermedia content, and cross-platform support
+</h3>
+
+<h4 align="center">
+  <a href="https://cycls.com">Website</a> |
+  <a href="https://docs.cycls.com">Docs</a> |
+  <a href="https://docs.cycls.com">Blog</a>
+</h4>
+
+<h4 align="center">
+  <a href="https://pypi.python.org/pypi/cycls"><img src="https://img.shields.io/pypi/v/cycls.svg?label=cycls+pypi&color=blueviolet" alt="cycls Python package on PyPi" /></a>
+  <a href="https://blog.cycls.com"><img src="https://img.shields.io/badge/newsletter-blueviolet.svg?logo=substack&label=cycls" alt="Cycls newsletter" /></a>
+  <a href="https://x.com/cycls_">
+    <img src="https://img.shields.io/twitter/follow/cycls_" alt="Cycls Twitter" />
+  </a>
+</h4>
+
+
+## Cycls: The AI App Generator
+Cycls[^1] streamlines AI application development by generating apps from high-level descriptions. It eliminates boilerplate, ensures cross-platform compatibility, and manages memory - all from a single codebase.
+
+With Cycls, you can quickly prototype ideas and then turn them into production apps, while focusing on AI logic and user interactions rather than wrestling with implementation details.
+
+## ✨ Core Features
+- **Fast App Generation**: Create live web apps from code in minutes
+- **Built-in Memory Management**: Integrated state and session management
+- **Rich Hypermedia Content**: Support for various media types (text, images, audio, video, interactive elements)
+- **Framework Agnostic**: Compatible with a wide range of AI frameworks and models
+
+## 🚀 Quickstart
+### Installation
+```
+pip install cycls
+```
+
+### Basic usage
+```py
+from cycls import Cycls
+
+cycls = Cycls()
+
+@cycls("@my-app")
+def app():
+    return "Hello World!"
+
+cycls.push()
+```
+This creates an app named "@my-app" that responds with "Hello World!".
+
+The `@cycls("@my-app")` decorator registers your app, and `cycls.push()` streams it to Cycls platform.
+
+To see a live example, visit https://cycls.com/@spark.
+
+> [!IMPORTANT]
+> Use a unique name for your app (like "@my-app"). This is your app's identifier on Cycls.
+
+> [!NOTE]
+> Your apps run on your infrastructure and are streamed in real-time to Cycls.
+
+## 📖 Documentation
+For more detailes and instructions, visit our documentation at [docs.cycls.com](https://docs.cycls.com/).
+
+## 🗺️ Roadmap
+- **iOS and Android apps**
+- **User management**
+- **JavaScript SDK**
+- **Public API**
+- **Cross-app communication**
+
+## 🙌 Support 
+Join our Discord community for support and discussions. You can reach us on:
+
+- [Join our Discord](https://discord.gg/XbxcTFBf7J)
+- [Join our newsletter](https://blog.cycls.com)
+- [Follow us on Twitter](https://x.com/cycls_)
+- [Email us](mailto:hi@cycls.com)
+
+[^1]: The name "Cycls" is a play on "cycles," referring to the continuous exchange between AI prompts (generators) and their responses (generated).
+

cycls-0.0.2.24.dist-info/RECORD

@@ -0,0 +1,6 @@
+cycls/__init__.py,sha256=HPPQikt_Trbc4s8XyEOeOjB_JRWXlXIkJuh762nUM_g,24
+cycls/cycls.py,sha256=_vCiIUeyDJhC3ANSh5aOSkHw38-k8cuwuYCCmx_yOEg,4731
+cycls/tuns,sha256=CT8olxDKOM0cY6r_bbSGtnWyEmEYFVDVHj9ug3gbYHk,1843
+cycls-0.0.2.24.dist-info/METADATA,sha256=UsbfVWCgu2-uk_3R4tGui1GxP2Q3WstfSNumcWVezHM,3672
+cycls-0.0.2.24.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+cycls-0.0.2.24.dist-info/RECORD,,

cycls-0.0.2.22.dist-info/METADATA

@@ -1,92 +0,0 @@
-Metadata-Version: 2.1
-Name: cycls
-Version: 0.0.2.22
-Summary: Cycls SDK
-Author: Mohammed Jamal
-Author-email: mj@cycls.com
-Requires-Python: >=3.8,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: asyncssh (>=2.14.2,<3.0.0)
-Requires-Dist: fastapi (>=0.111.0,<0.112.0)
-Requires-Dist: httpx (>=0.27.0,<0.28.0)
-Description-Content-Type: text/markdown
-
-</br></br>
-<p align="center">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://cycls.com/static/assets/logo-gold.svg">
-      <source media="(prefers-color-scheme: light)" srcset="https://cycls.com/static/assets/logo.svg">
-      <img alt="Cycls" src="https://cycls.com/static/assets/logo.svg" width="150">
-    </picture>
-</p>
-</br></br>
-
-<div align="center">
-    <a href="https://pypi.org/project/cycls/" target="_blank" rel="noopener noreferrer">
-        <img loading="lazy" src="https://img.shields.io/pypi/v/cycls.svg" alt="PyPI" class="img_ev3q" style="display: inline;">
-    </a>
-    <a href="https://discord.gg/BMnaMatDC7" target="_blank" rel="noopener noreferrer">
-        <img loading="lazy" src="https://img.shields.io/discord/1175782747164389466" alt="Discord" class="img_ev3q" style="display: inline;">
-    </a>
-</div>
-
-</br>
-
-```sh
-pip install cycls
-```
-
-# Apps ✦
-Instantly publish and share AI apps
-
-```py
-from cycls import Cycls
-
-cycls = Cycls()
-
-@cycls("@spark")
-def app(x):
-    return x.content + "from spark"
-
-cycls.push()
-```
-`cycls.push()` will then publish the app `@spark` on [cycls.com/@spark](https://cycls.com/@spark)
-## Async Apps
-For performance, make the function asynchronous. The following is an async app with message `history` and session `id`
-```py
-from cycls import Cycls
-
-cycls = Cycls()
-
-@cycls("@spark")
-async def app(x):
-    print(x.history, x.id)
-    return x.content + "from spark"
-
-cycls.push()
-```
-
-# Agents ✧
-Call any public app as an agent, see [explore](https://explore.cycls.com)
-```py
-from cycls import Cycls
-
-cycls = Cycls()
-
-@cycls("@spark")
-async def app(x):
-    return cycls.call("@groq",
-                       x.content)
-
-cycls.push()
-```
-
-### Try it live
-- [cycls.com/@groq](https://cycls.com/@groq)     | [groq.py](https://github.com/Cycls/examples/blob/main/groq.py)
-- [cycls.com/@openai](https://cycls.com/@openai) | [openai.py](https://github.com/Cycls/examples/blob/main/openai.py)
-

cycls-0.0.2.22.dist-info/RECORD

@@ -1,6 +0,0 @@
-cycls/__init__.py,sha256=HPPQikt_Trbc4s8XyEOeOjB_JRWXlXIkJuh762nUM_g,24
-cycls/cycls.py,sha256=GVC6IJ9AhKjNY5KA_osP2mbWjlDdymkWNNQuyQ6a8jA,4794
-cycls/tuns,sha256=CT8olxDKOM0cY6r_bbSGtnWyEmEYFVDVHj9ug3gbYHk,1843
-cycls-0.0.2.22.dist-info/METADATA,sha256=rWDwf1rez9xYZnLOh3o5C8osTajOrC3CIvyyyT2IliU,2593
-cycls-0.0.2.22.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-cycls-0.0.2.22.dist-info/RECORD,,