{"id":23933019,"url":"https://github.com/dponcedeleonf/instantneo","last_synced_at":"2025-09-11T15:33:25.500Z","repository":{"id":201103803,"uuid":"706973364","full_name":"dponcedeleonf/instantneo","owner":"dponcedeleonf","description":"InstantNeo: Instant agents as the building blocks of intelligent systems. A Python library for creating LLM-based agents with granular control and simple composition.","archived":false,"fork":false,"pushed_at":"2025-09-01T14:57:30.000Z","size":253,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-01T16:42:56.905Z","etag":null,"topics":["agent-framework","agents","ai-agents","llm-agent","multi-agent-systems"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dponcedeleonf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-10-19T01:10:23.000Z","updated_at":"2025-03-27T13:06:56.000Z","dependencies_parsed_at":"2023-10-23T16:27:45.700Z","dependency_job_id":"14523f69-a33e-4a09-977a-e8aeec395ffe","html_url":"https://github.com/dponcedeleonf/instantneo","commit_stats":null,"previous_names":["dponcedeleonf/instantneo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dponcedeleonf/instantneo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dponcedeleonf%2Finstantneo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dponcedeleonf%2Finstantneo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dponcedeleonf%2Finstantneo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dponcedeleonf%2Finstantneo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dponcedeleonf","download_url":"https://codeload.github.com/dponcedeleonf/instantneo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dponcedeleonf%2Finstantneo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274660279,"owners_count":25326172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-11T02:00:13.660Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agent-framework","agents","ai-agents","llm-agent","multi-agent-systems"],"created_at":"2025-01-06T00:29:29.454Z","updated_at":"2025-09-11T15:33:25.478Z","avatar_url":"https://github.com/dponcedeleonf.png","language":"Python","funding_links":[],"categories":["Building","Agent Categories"],"sub_categories":["Deployment","\u003ca name=\"Unclassified\"\u003e\u003c/a\u003eUnclassified"],"readme":"# InstantNeo\n\n\u003cdiv align=\"center\"\u003e\n\n![InstantNeo Logo](https://raw.githubusercontent.com/dponcedeleonf/instantneo/refs/heads/desarrollo/docs/img/logo_instantneo.png)\n\n[![PyPI version](https://img.shields.io/pypi/v/instantneo.svg)](https://pypi.org/project/instantneo/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/instantneo.svg)](https://pypi.org/project/instantneo/)\n[![License](https://img.shields.io/github/license/dponcedeleonf/instantneo.svg)](https://github.com/dponcedeleonf/instantneo/blob/main/LICENSE)\n\n\u003cdiv align=\"center\"\u003e\n\n  \u003ch2\u003e\u003cb\u003eBuild instant agents to compose intelligent systems\u003c/b\u003e\u003c/h2\u003e\n  \u003cp\u003e\u003ci\u003e\"I know kung fu.\" - Neo\u003c/i\u003e\u003c/p\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\n## What is InstantNeo?\n\nInstantNeo is a Python library that lets you create LLM-based agents quickly and concisely, designed as components for intelligent systems. It offers a clean, direct interface for granular control over agent behavior, abstracting away provider complexity. Like Neo in *The Matrix* downloading skills instantly, InstantNeo lets you build agents with instant capabilities, simple to start and powerful when composed. Unlike rigid or overly-elaborated frameworks, InstantNeo draws from Marvin Minsky's 'Society of Mind' to deliver modular building blocks, letting you craft multi-agent systems your way.\n\n## Features\n\n- **Unified Provider Interface:** Switch seamlessly between models providers with consistent syntax. The library handles different API requirements behind the scenes.\n- **Quick and powerful Skill Management:** Define agent capabilities using simple Python decorators that transform functions into skills with metadata, descriptions, and parameter validation. Add, remove, and list skills dynamically as your agent's needs evolve.\n- **Flexible Execution Modes:** Control exactly how skills are executed with three modes: wait for results, fire skills in the background, or just extract arguments without execution for planning purposes.\n- **Text and Image Support:** Process both text and images through a single consistent API. Send images alongside prompts to vision-capable models and control the level of image analysis detail as needed.\n- **Customizable Agent Settings:** Modify agent behavior on-the-fly by overriding temperature, max tokens, role setup, and other parameters for specific interactions without recreating the entire agent.\n\n## Installation\nInstantNeo requires specifying which providers will be installed. You can use [all] to install dependencies for all supported providers:\n\n```bash\npip install instantneo[all]\n```\n\n```bash\npip install instantneo[openai]\n```\n\n```bash\npip install instantneo[groq]\n```\n\n```bash\npip install instantneo[anthropic]\n```\n\n## Quickstart\n\n### Wake Neo Up\n\n```python\nfrom instantneo import InstantNeo\n\nneo = InstantNeo(\n    provider=\"openai\", \n    api_key=\"your-api-key\", \n    model=\"gpt-4o\",\n    role_setup=\"You are Neo, the chosen one. Ready to learn anything.\"\n)\n\nprint(neo.run(\"What's the Matrix?\"))\n```\n\n### Teach Him Kung Fu\n\n```python\nfrom instantneo.skills import skill\nfrom instantneo import InstantNeo\n\n@skill(description=\"Execute a kung fu move\", parameters={\"move\": \"e.g., dragon punch\", \"intensity\": \"1-10\"})\ndef kung_fu(move: str, intensity: int = 5) -\u003e str:\n    return f\"Hit {move} at intensity {intensity}. I know kung fu!\"\n\nneo = InstantNeo(\n    provider=\"anthropic\",\n    api_key=\"your-api-key\",\n    model=\"claude-3-7-sonnet-20250219\",\n    role_setup=\"You are Neo, martial arts downloaded.\",\n    skills=[\"kung_fu\"]\n)\n\nprint(neo.run(\"Three agents ahead. What move?\"))\n```\n\n## API Reference\n\n- **InstantNeo Class**: Set provider, api_key, model, role_setup, plus skills and tuning params (temperature, max_tokens, etc.).\n- **run() Method**: Feed it a prompt, pick an execution_mode (WAIT_RESPONSE, EXECUTION_ONLY, GET_ARGS), override settings as needed.\n\nDetails in the docs.\n\n## Architecture and Philosophy\n\nInstantNeo leans on Minsky's \"Society of Mind\": small, specialized agents you connect to make something bigger. Each agent's a tool—give it a role, add skills, and weave them together. The smarts come from your coordination, not ours.\n\n## Documentation\n\nFull scoop at instantneo.readthedocs.io, including tutorials on multi-agent setups and advanced skills.\n\n## Contributing\n\nFork, branch, commit, push, PR. Update tests and docs if you're adding something.\n\n## License\n\nMIT License—check LICENSE.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\u003ci\u003e\"I'm trying to free your mind, Neo. But I can only show you the door. You're the one that has to walk through it.\" - Morpheus\u003c/i\u003e\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdponcedeleonf%2Finstantneo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdponcedeleonf%2Finstantneo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdponcedeleonf%2Finstantneo/lists"}