{"id":23425458,"url":"https://github.com/fal-ai/fal-java","last_synced_at":"2025-10-07T03:51:08.828Z","repository":{"id":212154587,"uuid":"726157579","full_name":"fal-ai/fal-java","owner":"fal-ai","description":"A JVM-compatible, Java \u0026 Kotlin, client for the fal.ai model APIs ","archived":false,"fork":false,"pushed_at":"2024-09-10T03:34:08.000Z","size":511,"stargazers_count":14,"open_issues_count":2,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-10-01T23:39:40.098Z","etag":null,"topics":["ai","fal","generative-ai","java","kotlin"],"latest_commit_sha":null,"homepage":"https://fal.ai","language":"Java","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/fal-ai.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}},"created_at":"2023-12-01T16:51:28.000Z","updated_at":"2025-05-13T02:17:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"670aa2d9-3744-414b-a08b-2a0e086fc2a0","html_url":"https://github.com/fal-ai/fal-java","commit_stats":null,"previous_names":["fal-ai/fal-kotlin","fal-ai/fal-java"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fal-ai/fal-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fal-ai%2Ffal-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fal-ai%2Ffal-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fal-ai%2Ffal-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fal-ai%2Ffal-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fal-ai","download_url":"https://codeload.github.com/fal-ai/fal-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fal-ai%2Ffal-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278717446,"owners_count":26033542,"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-10-07T02:00:06.786Z","response_time":59,"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":["ai","fal","generative-ai","java","kotlin"],"created_at":"2024-12-23T05:12:51.584Z","updated_at":"2025-10-07T03:51:08.797Z","avatar_url":"https://github.com/fal-ai.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## The fal.ai JVM Client for Java and Kotlin\n\n![License](https://img.shields.io/badge/license-MIT-blue)\n\n## About the Project\n\nThe `FalClient` is a robust and user-friendly Java implementation of the [fal.ai](https://fal.ai) client.\n\n## Getting Started\n\nThe `FalClient` library serves as a client for fal serverless Python functions. Before using this library, ensure you've got your fal key from [our dashboard](https://fal.ai/dashboard/keys).\n\nThe client is available on Maven Central. There are three different modules:\n\n- `fal-client`: The main client library, implemented in Java, with synchronous interfaces.\n- `fal-client-async`: The asynchronous version of the client library, implemented in Java.\n- `fal-client-kotlin`: The Kotlin version of the client library, with coroutines support, implemented on top of the `fal-client-async` module.\n\nThe\n\n### Client Library\n\n#### Synchronous\n\n##### Install\n\n```groovy\nimplementation \"ai.fal.client:fal-client:0.7.1\"\n```\n\n##### Call the API\n\n```java\nimport ai.fal.client.*;\n\nvar fal = FalClient.withEnvCredentials();\n\nvar input = Map.of(\n    \"prompt\", \"A cute shih-tzu puppy\"\n);\nvar result = fal.subscribe(\"fal-ai/fast-sdxl\",\n    SubscribeOptions.\u003cJsonObject\u003ebuilder()\n        .input(input)\n        .resultType(JsonObject.class)\n        .onQueueUpdate(update -\u003e {\n            System.out.println(update.getStatus());\n        })\n        .build()\n);\nSystem.out.println(result.getRequestId());\nSystem.out.println(result.getData());\n```\n\n#### Asynchronous\n\n##### Install\n\n```groovy\nimplementation \"ai.fal.client:fal-client-async:0.7.1\"\n```\n\n##### Call the API\n\n```java\nimport ai.fal.client.*;\n\nvar fal = AsyncFalClient.withEnvCredentials();\n\nvar input = Map.of(\n    \"prompt\", \"A cute shih-tzu puppy\"\n);\nvar future = fal.subscribe(\"fal-ai/fast-sdxl\",\n    SubscribeOptions.\u003cJsonObject\u003ebuilder()\n        .input(input)\n        .resultType(JsonObject.class)\n        .onQueueUpdate(update -\u003e {\n            System.out.println(update.getStatus());\n        })\n        .build()\n);\nfuture.thenAccept(result -\u003e {\n    System.out.println(result.getRequestId());\n    System.out.println(result.getData());\n});\n```\n\n#### Kotlin\n\n##### Install\n\n```groovy\nimplementation \"ai.fal.client:fal-client-kotlin:0.7.1\"\n```\n\n##### Call the API\n\n```kotlin\nimport ai.fal.client.kt.*\n\nval fal = createFalClient()\n\nval result = fal.subscribe(\"fal-ai/fast-sdxl\", input = mapOf(\n    \"prompt\" to \"A cute shih-tzu puppy\"\n)) { update -\u003e\n    print(update.status)\n}\nprint(result.requestId)\nprint(result.data)\n```\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make to the Kotlin version of the client are **greatly appreciated**.\n\n## License\n\nDistributed under the MIT License. See [LICENSE](https://github.com/fal-ai/serverless-client-swift/blob/main/LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffal-ai%2Ffal-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffal-ai%2Ffal-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffal-ai%2Ffal-java/lists"}