{"id":37071507,"url":"https://github.com/chigwell/animtoreal","last_synced_at":"2026-01-14T08:23:26.977Z","repository":{"id":329754261,"uuid":"1120586614","full_name":"chigwell/animtoreal","owner":"chigwell","description":"This new package enables users to input a description or details about an animated character and receive a structured summary or step-by-step plan to bring that character into the real world, such as ","archived":false,"fork":false,"pushed_at":"2025-12-21T14:32:52.000Z","size":6,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-23T05:06:39.504Z","etag":null,"topics":["animated-character","character-design","conceptual-organization","costume-development","creative-facilitation","creative-workflow","development-process","interactive-experience","language-model-integration","media-independent-processing","physical-realization","production-planning","prop-design","step-by-step-guide","structured-summary"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/animtoreal/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chigwell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-21T14:32:40.000Z","updated_at":"2025-12-21T14:33:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chigwell/animtoreal","commit_stats":null,"previous_names":["chigwell/animtoreal"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/chigwell/animtoreal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigwell%2Fanimtoreal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigwell%2Fanimtoreal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigwell%2Fanimtoreal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigwell%2Fanimtoreal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chigwell","download_url":"https://codeload.github.com/chigwell/animtoreal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigwell%2Fanimtoreal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28413856,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:16:59.381Z","status":"ssl_error","status_checked_at":"2026-01-14T08:13:45.490Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animated-character","character-design","conceptual-organization","costume-development","creative-facilitation","creative-workflow","development-process","interactive-experience","language-model-integration","media-independent-processing","physical-realization","production-planning","prop-design","step-by-step-guide","structured-summary"],"created_at":"2026-01-14T08:23:26.281Z","updated_at":"2026-01-14T08:23:26.970Z","avatar_url":"https://github.com/chigwell.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# animtoreal\n[![PyPI version](https://badge.fury.io/py/animtoreal.svg)](https://badge.fury.io/py/animtoreal)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![Downloads](https://static.pepy.tech/badge/animtoreal)](https://pepy.tech/project/animtoreal)\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-blue)](https://www.linkedin.com/in/eugene-evstafev-716669181/)\n\n\n`animtoreal` is a lightweight Python package that turns a textual description of an animated character into a structured, step‑by‑step plan for bringing that character into the real world.  \nIt extracts key information such as props, costumes, interactive experiences and other production details using a large language model, without requiring any media files.\n\n\u003e **Why use animtoreal?**  \n\u003e - Quickly generate a production‑ready spec from a creative brief.  \n\u003e - Leverage any LLM – the package ships with a default free‑tier LLM (`ChatLLM7`) but you can plug in OpenAI, Anthropic, Google Gemini, or any LangChain‑compatible model.  \n\u003e - No heavy dependencies or UI required – just a single function call.\n\n---\n\n## 📦 Installation\n\n```bash\npip install animtoreal\n```\n\n---\n\n## 🚀 Quick Start\n\n```python\nfrom animtoreal import animtoreal\n\nuser_input = \"\"\"\nI want to create a small floating silver robot that can interact with children.\nIt should have smooth metal panels, a small LED face that displays simple emotions,\nand a lightweight adjustable arm that can point at objects. The robot must be\nbattery powered, easy to clean, and have a friendly safety char.\n\"\"\"\n\n# Using the built‑in default LLM (ChatLLM7)\nresponse = animtoreal(user_input)\nprint(response)\n```\n\n`response` will be a list of strings, each representing a structured element of the production plan.\n\n---\n\n## 📚 Function Signature\n\n```python\nanimtoreal(\n    user_input: str,\n    api_key: Optional[str] = None,\n    llm: Optional[BaseChatModel] = None\n) -\u003e List[str]\n```\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `user_input` | `str` | Text description of the character. |\n| `llm` | `Optional[BaseChatModel]` | A LangChain ChatModel instance. If omitted, the default `ChatLLM7` is used. |\n| `api_key` | `Optional[str]` | API key for LLM7. If omitted, the package will look for `LLM7_API_KEY` in the environment, and fall back to `\"None\"` (for the free tier). |\n\n---\n\n## 🔗 Using Your Own LLM\n\n`animtoreal` is agnostic to the underlying LLM.  \nBelow are quick examples with popular providers.\n\n### OpenAI\n\n```python\nfrom langchain_openai import ChatOpenAI\nfrom animtoreal import animtoreal\n\nllm = ChatOpenAI()  # defaults to your OPENAI_API_KEY env var\nresponse = animtoreal(user_input, llm=llm)\n```\n\n### Anthropic\n\n```python\nfrom langchain_anthropic import ChatAnthropic\nfrom animtoreal import animtoreal\n\nllm = ChatAnthropic()\nresponse = animtoreal(user_input, llm=llm)\n```\n\n### Google Gemini\n\n```python\nfrom langchain_google_genai import ChatGoogleGenerativeAI\nfrom animtoreal import animtoreal\n\nllm = ChatGoogleGenerativeAI()\nresponse = animtoreal(user_input, llm=llm)\n```\n\n---\n\n## 🔒 LLM7 API Key \u0026 Rate Limits\n\n- The default free tier of **LLM7** is usually sufficient for most small‑to‑medium projects.  \n- If you need higher limits, provide your key via an environment variable:\n\n  ```bash\n  export LLM7_API_KEY=\"your_real_api_key\"\n  ```\n\n  or pass it directly:\n\n  ```python\n  response = animtoreal(user_input, api_key=\"your_real_api_key\")\n  ```\n\n- Obtain a free key at: \u003chttps://token.llm7.io/\u003e\n\n---\n\n## 🤝 Contributing \u0026 Issues\n\n- **GitHub Issues**: \u003chttps://github.com/chigwell/animtoreal/issues\u003e  \n\nFeel free to open an issue if you encounter bugs or have feature requests.\n\n---\n\n## 📄 Licensing\n\nThis project is open source under the MIT License. (Adapt as appropriate.)\n\n---\n\n## 👤 Maintainer\n\n- **Eugene Evstafev**  \n  [hi@euegne.plus](mailto:hi@euegne.plus)  \n  GitHub: [@chigwell](https://github.com/chigwell)\n\n---\n\nHappy creating! 🎨🦾","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchigwell%2Fanimtoreal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchigwell%2Fanimtoreal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchigwell%2Fanimtoreal/lists"}