PraisonAI 3.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (393) hide show
  1. praisonai/__init__.py +54 -0
  2. praisonai/__main__.py +15 -0
  3. praisonai/acp/__init__.py +54 -0
  4. praisonai/acp/config.py +159 -0
  5. praisonai/acp/server.py +587 -0
  6. praisonai/acp/session.py +219 -0
  7. praisonai/adapters/__init__.py +50 -0
  8. praisonai/adapters/readers.py +395 -0
  9. praisonai/adapters/rerankers.py +315 -0
  10. praisonai/adapters/retrievers.py +394 -0
  11. praisonai/adapters/vector_stores.py +409 -0
  12. praisonai/agent_scheduler.py +337 -0
  13. praisonai/agents_generator.py +903 -0
  14. praisonai/api/call.py +292 -0
  15. praisonai/auto.py +1197 -0
  16. praisonai/capabilities/__init__.py +275 -0
  17. praisonai/capabilities/a2a.py +140 -0
  18. praisonai/capabilities/assistants.py +283 -0
  19. praisonai/capabilities/audio.py +320 -0
  20. praisonai/capabilities/batches.py +469 -0
  21. praisonai/capabilities/completions.py +336 -0
  22. praisonai/capabilities/container_files.py +155 -0
  23. praisonai/capabilities/containers.py +93 -0
  24. praisonai/capabilities/embeddings.py +158 -0
  25. praisonai/capabilities/files.py +467 -0
  26. praisonai/capabilities/fine_tuning.py +293 -0
  27. praisonai/capabilities/guardrails.py +182 -0
  28. praisonai/capabilities/images.py +330 -0
  29. praisonai/capabilities/mcp.py +190 -0
  30. praisonai/capabilities/messages.py +270 -0
  31. praisonai/capabilities/moderations.py +154 -0
  32. praisonai/capabilities/ocr.py +217 -0
  33. praisonai/capabilities/passthrough.py +204 -0
  34. praisonai/capabilities/rag.py +207 -0
  35. praisonai/capabilities/realtime.py +160 -0
  36. praisonai/capabilities/rerank.py +165 -0
  37. praisonai/capabilities/responses.py +266 -0
  38. praisonai/capabilities/search.py +109 -0
  39. praisonai/capabilities/skills.py +133 -0
  40. praisonai/capabilities/vector_store_files.py +334 -0
  41. praisonai/capabilities/vector_stores.py +304 -0
  42. praisonai/capabilities/videos.py +141 -0
  43. praisonai/chainlit_ui.py +304 -0
  44. praisonai/chat/__init__.py +106 -0
  45. praisonai/chat/app.py +125 -0
  46. praisonai/cli/__init__.py +26 -0
  47. praisonai/cli/app.py +213 -0
  48. praisonai/cli/commands/__init__.py +75 -0
  49. praisonai/cli/commands/acp.py +70 -0
  50. praisonai/cli/commands/completion.py +333 -0
  51. praisonai/cli/commands/config.py +166 -0
  52. praisonai/cli/commands/debug.py +142 -0
  53. praisonai/cli/commands/diag.py +55 -0
  54. praisonai/cli/commands/doctor.py +166 -0
  55. praisonai/cli/commands/environment.py +179 -0
  56. praisonai/cli/commands/lsp.py +112 -0
  57. praisonai/cli/commands/mcp.py +210 -0
  58. praisonai/cli/commands/profile.py +457 -0
  59. praisonai/cli/commands/run.py +228 -0
  60. praisonai/cli/commands/schedule.py +150 -0
  61. praisonai/cli/commands/serve.py +97 -0
  62. praisonai/cli/commands/session.py +212 -0
  63. praisonai/cli/commands/traces.py +145 -0
  64. praisonai/cli/commands/version.py +101 -0
  65. praisonai/cli/configuration/__init__.py +18 -0
  66. praisonai/cli/configuration/loader.py +353 -0
  67. praisonai/cli/configuration/paths.py +114 -0
  68. praisonai/cli/configuration/schema.py +164 -0
  69. praisonai/cli/features/__init__.py +268 -0
  70. praisonai/cli/features/acp.py +236 -0
  71. praisonai/cli/features/action_orchestrator.py +546 -0
  72. praisonai/cli/features/agent_scheduler.py +773 -0
  73. praisonai/cli/features/agent_tools.py +474 -0
  74. praisonai/cli/features/agents.py +375 -0
  75. praisonai/cli/features/at_mentions.py +471 -0
  76. praisonai/cli/features/auto_memory.py +182 -0
  77. praisonai/cli/features/autonomy_mode.py +490 -0
  78. praisonai/cli/features/background.py +356 -0
  79. praisonai/cli/features/base.py +168 -0
  80. praisonai/cli/features/capabilities.py +1326 -0
  81. praisonai/cli/features/checkpoints.py +338 -0
  82. praisonai/cli/features/code_intelligence.py +652 -0
  83. praisonai/cli/features/compaction.py +294 -0
  84. praisonai/cli/features/compare.py +534 -0
  85. praisonai/cli/features/cost_tracker.py +514 -0
  86. praisonai/cli/features/debug.py +810 -0
  87. praisonai/cli/features/deploy.py +517 -0
  88. praisonai/cli/features/diag.py +289 -0
  89. praisonai/cli/features/doctor/__init__.py +63 -0
  90. praisonai/cli/features/doctor/checks/__init__.py +24 -0
  91. praisonai/cli/features/doctor/checks/acp_checks.py +240 -0
  92. praisonai/cli/features/doctor/checks/config_checks.py +366 -0
  93. praisonai/cli/features/doctor/checks/db_checks.py +366 -0
  94. praisonai/cli/features/doctor/checks/env_checks.py +543 -0
  95. praisonai/cli/features/doctor/checks/lsp_checks.py +199 -0
  96. praisonai/cli/features/doctor/checks/mcp_checks.py +349 -0
  97. praisonai/cli/features/doctor/checks/memory_checks.py +268 -0
  98. praisonai/cli/features/doctor/checks/network_checks.py +251 -0
  99. praisonai/cli/features/doctor/checks/obs_checks.py +328 -0
  100. praisonai/cli/features/doctor/checks/performance_checks.py +235 -0
  101. praisonai/cli/features/doctor/checks/permissions_checks.py +259 -0
  102. praisonai/cli/features/doctor/checks/selftest_checks.py +322 -0
  103. praisonai/cli/features/doctor/checks/serve_checks.py +426 -0
  104. praisonai/cli/features/doctor/checks/skills_checks.py +231 -0
  105. praisonai/cli/features/doctor/checks/tools_checks.py +371 -0
  106. praisonai/cli/features/doctor/engine.py +266 -0
  107. praisonai/cli/features/doctor/formatters.py +310 -0
  108. praisonai/cli/features/doctor/handler.py +397 -0
  109. praisonai/cli/features/doctor/models.py +264 -0
  110. praisonai/cli/features/doctor/registry.py +239 -0
  111. praisonai/cli/features/endpoints.py +1019 -0
  112. praisonai/cli/features/eval.py +560 -0
  113. praisonai/cli/features/external_agents.py +231 -0
  114. praisonai/cli/features/fast_context.py +410 -0
  115. praisonai/cli/features/flow_display.py +566 -0
  116. praisonai/cli/features/git_integration.py +651 -0
  117. praisonai/cli/features/guardrail.py +171 -0
  118. praisonai/cli/features/handoff.py +185 -0
  119. praisonai/cli/features/hooks.py +583 -0
  120. praisonai/cli/features/image.py +384 -0
  121. praisonai/cli/features/interactive_runtime.py +585 -0
  122. praisonai/cli/features/interactive_tools.py +380 -0
  123. praisonai/cli/features/interactive_tui.py +603 -0
  124. praisonai/cli/features/jobs.py +632 -0
  125. praisonai/cli/features/knowledge.py +531 -0
  126. praisonai/cli/features/lite.py +244 -0
  127. praisonai/cli/features/lsp_cli.py +225 -0
  128. praisonai/cli/features/mcp.py +169 -0
  129. praisonai/cli/features/message_queue.py +587 -0
  130. praisonai/cli/features/metrics.py +211 -0
  131. praisonai/cli/features/n8n.py +673 -0
  132. praisonai/cli/features/observability.py +293 -0
  133. praisonai/cli/features/ollama.py +361 -0
  134. praisonai/cli/features/output_style.py +273 -0
  135. praisonai/cli/features/package.py +631 -0
  136. praisonai/cli/features/performance.py +308 -0
  137. praisonai/cli/features/persistence.py +636 -0
  138. praisonai/cli/features/profile.py +226 -0
  139. praisonai/cli/features/profiler/__init__.py +81 -0
  140. praisonai/cli/features/profiler/core.py +558 -0
  141. praisonai/cli/features/profiler/optimizations.py +652 -0
  142. praisonai/cli/features/profiler/suite.py +386 -0
  143. praisonai/cli/features/profiling.py +350 -0
  144. praisonai/cli/features/queue/__init__.py +73 -0
  145. praisonai/cli/features/queue/manager.py +395 -0
  146. praisonai/cli/features/queue/models.py +286 -0
  147. praisonai/cli/features/queue/persistence.py +564 -0
  148. praisonai/cli/features/queue/scheduler.py +484 -0
  149. praisonai/cli/features/queue/worker.py +372 -0
  150. praisonai/cli/features/recipe.py +1723 -0
  151. praisonai/cli/features/recipes.py +449 -0
  152. praisonai/cli/features/registry.py +229 -0
  153. praisonai/cli/features/repo_map.py +860 -0
  154. praisonai/cli/features/router.py +466 -0
  155. praisonai/cli/features/sandbox_executor.py +515 -0
  156. praisonai/cli/features/serve.py +829 -0
  157. praisonai/cli/features/session.py +222 -0
  158. praisonai/cli/features/skills.py +856 -0
  159. praisonai/cli/features/slash_commands.py +650 -0
  160. praisonai/cli/features/telemetry.py +179 -0
  161. praisonai/cli/features/templates.py +1384 -0
  162. praisonai/cli/features/thinking.py +305 -0
  163. praisonai/cli/features/todo.py +334 -0
  164. praisonai/cli/features/tools.py +680 -0
  165. praisonai/cli/features/tui/__init__.py +83 -0
  166. praisonai/cli/features/tui/app.py +580 -0
  167. praisonai/cli/features/tui/cli.py +566 -0
  168. praisonai/cli/features/tui/debug.py +511 -0
  169. praisonai/cli/features/tui/events.py +99 -0
  170. praisonai/cli/features/tui/mock_provider.py +328 -0
  171. praisonai/cli/features/tui/orchestrator.py +652 -0
  172. praisonai/cli/features/tui/screens/__init__.py +50 -0
  173. praisonai/cli/features/tui/screens/main.py +245 -0
  174. praisonai/cli/features/tui/screens/queue.py +174 -0
  175. praisonai/cli/features/tui/screens/session.py +124 -0
  176. praisonai/cli/features/tui/screens/settings.py +148 -0
  177. praisonai/cli/features/tui/widgets/__init__.py +56 -0
  178. praisonai/cli/features/tui/widgets/chat.py +261 -0
  179. praisonai/cli/features/tui/widgets/composer.py +224 -0
  180. praisonai/cli/features/tui/widgets/queue_panel.py +200 -0
  181. praisonai/cli/features/tui/widgets/status.py +167 -0
  182. praisonai/cli/features/tui/widgets/tool_panel.py +248 -0
  183. praisonai/cli/features/workflow.py +720 -0
  184. praisonai/cli/legacy.py +236 -0
  185. praisonai/cli/main.py +5559 -0
  186. praisonai/cli/schedule_cli.py +54 -0
  187. praisonai/cli/state/__init__.py +31 -0
  188. praisonai/cli/state/identifiers.py +161 -0
  189. praisonai/cli/state/sessions.py +313 -0
  190. praisonai/code/__init__.py +93 -0
  191. praisonai/code/agent_tools.py +344 -0
  192. praisonai/code/diff/__init__.py +21 -0
  193. praisonai/code/diff/diff_strategy.py +432 -0
  194. praisonai/code/tools/__init__.py +27 -0
  195. praisonai/code/tools/apply_diff.py +221 -0
  196. praisonai/code/tools/execute_command.py +275 -0
  197. praisonai/code/tools/list_files.py +274 -0
  198. praisonai/code/tools/read_file.py +206 -0
  199. praisonai/code/tools/search_replace.py +248 -0
  200. praisonai/code/tools/write_file.py +217 -0
  201. praisonai/code/utils/__init__.py +46 -0
  202. praisonai/code/utils/file_utils.py +307 -0
  203. praisonai/code/utils/ignore_utils.py +308 -0
  204. praisonai/code/utils/text_utils.py +276 -0
  205. praisonai/db/__init__.py +64 -0
  206. praisonai/db/adapter.py +531 -0
  207. praisonai/deploy/__init__.py +62 -0
  208. praisonai/deploy/api.py +231 -0
  209. praisonai/deploy/docker.py +454 -0
  210. praisonai/deploy/doctor.py +367 -0
  211. praisonai/deploy/main.py +327 -0
  212. praisonai/deploy/models.py +179 -0
  213. praisonai/deploy/providers/__init__.py +33 -0
  214. praisonai/deploy/providers/aws.py +331 -0
  215. praisonai/deploy/providers/azure.py +358 -0
  216. praisonai/deploy/providers/base.py +101 -0
  217. praisonai/deploy/providers/gcp.py +314 -0
  218. praisonai/deploy/schema.py +208 -0
  219. praisonai/deploy.py +185 -0
  220. praisonai/endpoints/__init__.py +53 -0
  221. praisonai/endpoints/a2u_server.py +410 -0
  222. praisonai/endpoints/discovery.py +165 -0
  223. praisonai/endpoints/providers/__init__.py +28 -0
  224. praisonai/endpoints/providers/a2a.py +253 -0
  225. praisonai/endpoints/providers/a2u.py +208 -0
  226. praisonai/endpoints/providers/agents_api.py +171 -0
  227. praisonai/endpoints/providers/base.py +231 -0
  228. praisonai/endpoints/providers/mcp.py +263 -0
  229. praisonai/endpoints/providers/recipe.py +206 -0
  230. praisonai/endpoints/providers/tools_mcp.py +150 -0
  231. praisonai/endpoints/registry.py +131 -0
  232. praisonai/endpoints/server.py +161 -0
  233. praisonai/inbuilt_tools/__init__.py +24 -0
  234. praisonai/inbuilt_tools/autogen_tools.py +117 -0
  235. praisonai/inc/__init__.py +2 -0
  236. praisonai/inc/config.py +96 -0
  237. praisonai/inc/models.py +155 -0
  238. praisonai/integrations/__init__.py +56 -0
  239. praisonai/integrations/base.py +303 -0
  240. praisonai/integrations/claude_code.py +270 -0
  241. praisonai/integrations/codex_cli.py +255 -0
  242. praisonai/integrations/cursor_cli.py +195 -0
  243. praisonai/integrations/gemini_cli.py +222 -0
  244. praisonai/jobs/__init__.py +67 -0
  245. praisonai/jobs/executor.py +425 -0
  246. praisonai/jobs/models.py +230 -0
  247. praisonai/jobs/router.py +314 -0
  248. praisonai/jobs/server.py +186 -0
  249. praisonai/jobs/store.py +203 -0
  250. praisonai/llm/__init__.py +66 -0
  251. praisonai/llm/registry.py +382 -0
  252. praisonai/mcp_server/__init__.py +152 -0
  253. praisonai/mcp_server/adapters/__init__.py +74 -0
  254. praisonai/mcp_server/adapters/agents.py +128 -0
  255. praisonai/mcp_server/adapters/capabilities.py +168 -0
  256. praisonai/mcp_server/adapters/cli_tools.py +568 -0
  257. praisonai/mcp_server/adapters/extended_capabilities.py +462 -0
  258. praisonai/mcp_server/adapters/knowledge.py +93 -0
  259. praisonai/mcp_server/adapters/memory.py +104 -0
  260. praisonai/mcp_server/adapters/prompts.py +306 -0
  261. praisonai/mcp_server/adapters/resources.py +124 -0
  262. praisonai/mcp_server/adapters/tools_bridge.py +280 -0
  263. praisonai/mcp_server/auth/__init__.py +48 -0
  264. praisonai/mcp_server/auth/api_key.py +291 -0
  265. praisonai/mcp_server/auth/oauth.py +460 -0
  266. praisonai/mcp_server/auth/oidc.py +289 -0
  267. praisonai/mcp_server/auth/scopes.py +260 -0
  268. praisonai/mcp_server/cli.py +852 -0
  269. praisonai/mcp_server/elicitation.py +445 -0
  270. praisonai/mcp_server/icons.py +302 -0
  271. praisonai/mcp_server/recipe_adapter.py +573 -0
  272. praisonai/mcp_server/recipe_cli.py +824 -0
  273. praisonai/mcp_server/registry.py +703 -0
  274. praisonai/mcp_server/sampling.py +422 -0
  275. praisonai/mcp_server/server.py +490 -0
  276. praisonai/mcp_server/tasks.py +443 -0
  277. praisonai/mcp_server/transports/__init__.py +18 -0
  278. praisonai/mcp_server/transports/http_stream.py +376 -0
  279. praisonai/mcp_server/transports/stdio.py +132 -0
  280. praisonai/persistence/__init__.py +84 -0
  281. praisonai/persistence/config.py +238 -0
  282. praisonai/persistence/conversation/__init__.py +25 -0
  283. praisonai/persistence/conversation/async_mysql.py +427 -0
  284. praisonai/persistence/conversation/async_postgres.py +410 -0
  285. praisonai/persistence/conversation/async_sqlite.py +371 -0
  286. praisonai/persistence/conversation/base.py +151 -0
  287. praisonai/persistence/conversation/json_store.py +250 -0
  288. praisonai/persistence/conversation/mysql.py +387 -0
  289. praisonai/persistence/conversation/postgres.py +401 -0
  290. praisonai/persistence/conversation/singlestore.py +240 -0
  291. praisonai/persistence/conversation/sqlite.py +341 -0
  292. praisonai/persistence/conversation/supabase.py +203 -0
  293. praisonai/persistence/conversation/surrealdb.py +287 -0
  294. praisonai/persistence/factory.py +301 -0
  295. praisonai/persistence/hooks/__init__.py +18 -0
  296. praisonai/persistence/hooks/agent_hooks.py +297 -0
  297. praisonai/persistence/knowledge/__init__.py +26 -0
  298. praisonai/persistence/knowledge/base.py +144 -0
  299. praisonai/persistence/knowledge/cassandra.py +232 -0
  300. praisonai/persistence/knowledge/chroma.py +295 -0
  301. praisonai/persistence/knowledge/clickhouse.py +242 -0
  302. praisonai/persistence/knowledge/cosmosdb_vector.py +438 -0
  303. praisonai/persistence/knowledge/couchbase.py +286 -0
  304. praisonai/persistence/knowledge/lancedb.py +216 -0
  305. praisonai/persistence/knowledge/langchain_adapter.py +291 -0
  306. praisonai/persistence/knowledge/lightrag_adapter.py +212 -0
  307. praisonai/persistence/knowledge/llamaindex_adapter.py +256 -0
  308. praisonai/persistence/knowledge/milvus.py +277 -0
  309. praisonai/persistence/knowledge/mongodb_vector.py +306 -0
  310. praisonai/persistence/knowledge/pgvector.py +335 -0
  311. praisonai/persistence/knowledge/pinecone.py +253 -0
  312. praisonai/persistence/knowledge/qdrant.py +301 -0
  313. praisonai/persistence/knowledge/redis_vector.py +291 -0
  314. praisonai/persistence/knowledge/singlestore_vector.py +299 -0
  315. praisonai/persistence/knowledge/surrealdb_vector.py +309 -0
  316. praisonai/persistence/knowledge/upstash_vector.py +266 -0
  317. praisonai/persistence/knowledge/weaviate.py +223 -0
  318. praisonai/persistence/migrations/__init__.py +10 -0
  319. praisonai/persistence/migrations/manager.py +251 -0
  320. praisonai/persistence/orchestrator.py +406 -0
  321. praisonai/persistence/state/__init__.py +21 -0
  322. praisonai/persistence/state/async_mongodb.py +200 -0
  323. praisonai/persistence/state/base.py +107 -0
  324. praisonai/persistence/state/dynamodb.py +226 -0
  325. praisonai/persistence/state/firestore.py +175 -0
  326. praisonai/persistence/state/gcs.py +155 -0
  327. praisonai/persistence/state/memory.py +245 -0
  328. praisonai/persistence/state/mongodb.py +158 -0
  329. praisonai/persistence/state/redis.py +190 -0
  330. praisonai/persistence/state/upstash.py +144 -0
  331. praisonai/persistence/tests/__init__.py +3 -0
  332. praisonai/persistence/tests/test_all_backends.py +633 -0
  333. praisonai/profiler.py +1214 -0
  334. praisonai/recipe/__init__.py +134 -0
  335. praisonai/recipe/bridge.py +278 -0
  336. praisonai/recipe/core.py +893 -0
  337. praisonai/recipe/exceptions.py +54 -0
  338. praisonai/recipe/history.py +402 -0
  339. praisonai/recipe/models.py +266 -0
  340. praisonai/recipe/operations.py +440 -0
  341. praisonai/recipe/policy.py +422 -0
  342. praisonai/recipe/registry.py +849 -0
  343. praisonai/recipe/runtime.py +214 -0
  344. praisonai/recipe/security.py +711 -0
  345. praisonai/recipe/serve.py +859 -0
  346. praisonai/recipe/server.py +613 -0
  347. praisonai/scheduler/__init__.py +45 -0
  348. praisonai/scheduler/agent_scheduler.py +552 -0
  349. praisonai/scheduler/base.py +124 -0
  350. praisonai/scheduler/daemon_manager.py +225 -0
  351. praisonai/scheduler/state_manager.py +155 -0
  352. praisonai/scheduler/yaml_loader.py +193 -0
  353. praisonai/scheduler.py +194 -0
  354. praisonai/setup/__init__.py +1 -0
  355. praisonai/setup/build.py +21 -0
  356. praisonai/setup/post_install.py +23 -0
  357. praisonai/setup/setup_conda_env.py +25 -0
  358. praisonai/setup.py +16 -0
  359. praisonai/templates/__init__.py +116 -0
  360. praisonai/templates/cache.py +364 -0
  361. praisonai/templates/dependency_checker.py +358 -0
  362. praisonai/templates/discovery.py +391 -0
  363. praisonai/templates/loader.py +564 -0
  364. praisonai/templates/registry.py +511 -0
  365. praisonai/templates/resolver.py +206 -0
  366. praisonai/templates/security.py +327 -0
  367. praisonai/templates/tool_override.py +498 -0
  368. praisonai/templates/tools_doctor.py +256 -0
  369. praisonai/test.py +105 -0
  370. praisonai/train.py +562 -0
  371. praisonai/train_vision.py +306 -0
  372. praisonai/ui/agents.py +824 -0
  373. praisonai/ui/callbacks.py +57 -0
  374. praisonai/ui/chainlit_compat.py +246 -0
  375. praisonai/ui/chat.py +532 -0
  376. praisonai/ui/code.py +717 -0
  377. praisonai/ui/colab.py +474 -0
  378. praisonai/ui/colab_chainlit.py +81 -0
  379. praisonai/ui/components/aicoder.py +284 -0
  380. praisonai/ui/context.py +283 -0
  381. praisonai/ui/database_config.py +56 -0
  382. praisonai/ui/db.py +294 -0
  383. praisonai/ui/realtime.py +488 -0
  384. praisonai/ui/realtimeclient/__init__.py +756 -0
  385. praisonai/ui/realtimeclient/tools.py +242 -0
  386. praisonai/ui/sql_alchemy.py +710 -0
  387. praisonai/upload_vision.py +140 -0
  388. praisonai/version.py +1 -0
  389. praisonai-3.0.0.dist-info/METADATA +3493 -0
  390. praisonai-3.0.0.dist-info/RECORD +393 -0
  391. praisonai-3.0.0.dist-info/WHEEL +5 -0
  392. praisonai-3.0.0.dist-info/entry_points.txt +4 -0
  393. praisonai-3.0.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,306 @@
1
+ #!/usr/bin/env python
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ This script finetunes a vision language model using Unsloth's fast training framework.
5
+ It supports vision tasks by converting raw image-caption samples into a conversation format,
6
+ adding vision-specific LoRA adapters, and training using TRL's SFTTrainer with UnslothVisionDataCollator.
7
+ """
8
+
9
+ import os
10
+ import sys
11
+ import yaml
12
+ import torch
13
+ import shutil
14
+ import subprocess
15
+ import gc # For garbage collection
16
+
17
+ from datasets import load_dataset, concatenate_datasets, Dataset
18
+ from unsloth import FastVisionModel, is_bf16_supported
19
+ from unsloth.trainer import UnslothVisionDataCollator
20
+ from transformers import TrainingArguments
21
+ from trl import SFTTrainer
22
+ from tqdm import tqdm # Add progress bar
23
+
24
+
25
+ class TrainVisionModel:
26
+ def __init__(self, config_path="config.yaml"):
27
+ self.load_config(config_path)
28
+ self.device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
29
+ self.model = None
30
+ self.hf_tokenizer = None # The underlying tokenizer
31
+
32
+ def load_config(self, path):
33
+ with open(path, "r") as file:
34
+ self.config = yaml.safe_load(file)
35
+ print("DEBUG: Loaded config:", self.config)
36
+
37
+ def print_system_info(self):
38
+ print("DEBUG: PyTorch version:", torch.__version__)
39
+ print("DEBUG: CUDA version:", torch.version.cuda)
40
+ if torch.cuda.is_available():
41
+ print("DEBUG: CUDA Device Capability:", torch.cuda.get_device_capability())
42
+ else:
43
+ print("DEBUG: CUDA is not available")
44
+ print("DEBUG: Python Version:", sys.version)
45
+ print("DEBUG: Python Path:", sys.executable)
46
+
47
+ def check_gpu(self):
48
+ gpu_stats = torch.cuda.get_device_properties(0)
49
+ print(f"DEBUG: GPU = {gpu_stats.name}. Max memory = {round(gpu_stats.total_memory/(1024**3),3)} GB.")
50
+
51
+ def check_ram(self):
52
+ from psutil import virtual_memory
53
+ ram_gb = virtual_memory().total / 1e9
54
+ print(f"DEBUG: Your runtime has {ram_gb:.1f} gigabytes of available RAM")
55
+ if ram_gb < 20:
56
+ print("DEBUG: Not using a high-RAM runtime")
57
+ else:
58
+ print("DEBUG: You are using a high-RAM runtime!")
59
+
60
+ def prepare_model(self):
61
+ print("DEBUG: Preparing vision model and tokenizer...")
62
+ self.model, original_tokenizer = FastVisionModel.from_pretrained(
63
+ model_name=self.config["model_name"],
64
+ load_in_4bit=self.config["load_in_4bit"],
65
+ use_gradient_checkpointing="unsloth"
66
+ )
67
+ print("DEBUG: Vision model and original tokenizer loaded.")
68
+
69
+ # Use the full processor that supports image inputs.
70
+ self.hf_tokenizer = original_tokenizer
71
+
72
+ # Set pad token if needed
73
+ if not hasattr(self.hf_tokenizer, 'pad_token') or self.hf_tokenizer.pad_token is None:
74
+ if hasattr(self.hf_tokenizer, 'eos_token'):
75
+ self.hf_tokenizer.pad_token = self.hf_tokenizer.eos_token
76
+ elif hasattr(self.hf_tokenizer, 'bos_token'):
77
+ self.hf_tokenizer.pad_token = self.hf_tokenizer.bos_token
78
+
79
+ # Set max length
80
+ if hasattr(self.hf_tokenizer, 'model_max_length'):
81
+ self.hf_tokenizer.model_max_length = self.config.get("max_seq_length", 2048)
82
+
83
+ # Add vision-specific LoRA adapters
84
+ self.model = FastVisionModel.get_peft_model(
85
+ self.model,
86
+ finetune_vision_layers=self.config.get("finetune_vision_layers", False),
87
+ finetune_language_layers=self.config.get("finetune_language_layers", True),
88
+ finetune_attention_modules=self.config.get("finetune_attention_modules", True),
89
+ finetune_mlp_modules=self.config.get("finetune_mlp_modules", True),
90
+ r=16,
91
+ lora_alpha=16,
92
+ lora_dropout=0,
93
+ bias="none",
94
+ random_state=3407,
95
+ use_rslora=False,
96
+ loftq_config=None
97
+ )
98
+ print("DEBUG: Vision LoRA adapters added.")
99
+
100
+ def convert_sample(self, sample):
101
+
102
+ instruction = self.config.get(
103
+ "vision_instruction",
104
+ "You are an expert radiographer. Describe accurately what you see in this image."
105
+ )
106
+ conversation = [
107
+ {
108
+ "role": "user",
109
+ "content": [
110
+ {"type": "text", "text": instruction},
111
+ {"type": "image", "image": sample["image"]}
112
+ ]
113
+ },
114
+ {
115
+ "role": "assistant",
116
+ "content": [
117
+ {"type": "text", "text": sample["caption"]}
118
+ ]
119
+ },
120
+ ]
121
+
122
+ return {"messages": conversation}
123
+
124
+ def load_datasets(self):
125
+ all_converted = []
126
+ for dataset_info in self.config["dataset"]:
127
+ print("\nDEBUG: Loading vision dataset:", dataset_info)
128
+ ds = load_dataset(
129
+ dataset_info["name"],
130
+ split=dataset_info.get("split_type", "train")
131
+ )
132
+ print("DEBUG: Dataset size:", len(ds))
133
+ print("DEBUG: First raw sample:", ds[0])
134
+ print("DEBUG: Dataset features:", ds.features)
135
+
136
+ print("\nDEBUG: Converting dataset to vision conversation format...")
137
+ converted_ds = [self.convert_sample(sample) for sample in ds]
138
+
139
+ # Debug first converted sample
140
+ print("\nDEBUG: First converted sample structure:")
141
+ first = converted_ds[0]
142
+ print("DEBUG: Message keys:", first["messages"][0]["content"][1].keys())
143
+ print("DEBUG: Image type in converted:", type(first["messages"][0]["content"][1].get("image")))
144
+
145
+ all_converted.extend(converted_ds)
146
+
147
+ print("\nDEBUG: Combined vision dataset has", len(all_converted), "examples.")
148
+ return all_converted
149
+
150
+ def train_model(self):
151
+ print("DEBUG: Starting vision training...")
152
+ raw_dataset = self.load_datasets()
153
+
154
+ # Build training arguments using TrainingArguments
155
+ training_args = TrainingArguments(
156
+ per_device_train_batch_size=self.config.get("per_device_train_batch_size", 1),
157
+ gradient_accumulation_steps=self.config.get("gradient_accumulation_steps", 4),
158
+ warmup_steps=self.config.get("warmup_steps", 5),
159
+ max_steps=self.config.get("max_steps", 30),
160
+ learning_rate=self.config.get("learning_rate", 2e-4),
161
+ fp16=self.config.get("fp16", not is_bf16_supported()),
162
+ bf16=self.config.get("bf16", is_bf16_supported()),
163
+ logging_steps=self.config.get("logging_steps", 1),
164
+ optim=self.config.get("optim", "adamw_8bit"),
165
+ weight_decay=self.config.get("weight_decay", 0.01),
166
+ lr_scheduler_type=self.config.get("lr_scheduler_type", "linear"),
167
+ seed=self.config.get("seed", 3407),
168
+ output_dir=self.config.get("output_dir", "outputs"),
169
+ report_to="none" if not os.getenv("PRAISON_WANDB") else "wandb",
170
+ remove_unused_columns=False,
171
+ # Add memory optimization settings
172
+ gradient_checkpointing=True,
173
+ max_grad_norm=1.0,
174
+ )
175
+
176
+ trainer = SFTTrainer(
177
+ model=self.model,
178
+ tokenizer=self.hf_tokenizer,
179
+ data_collator=UnslothVisionDataCollator(self.model, self.hf_tokenizer),
180
+ train_dataset=raw_dataset,
181
+ args=training_args,
182
+ max_seq_length=self.config.get("max_seq_length", 2048),
183
+ dataset_text_field="", # Required for vision training
184
+ dataset_kwargs={"skip_prepare_dataset": True}, # Required for vision training
185
+ packing=False # Explicitly set packing to False
186
+ )
187
+ print("DEBUG: Beginning vision trainer.train() ...")
188
+ trainer.train()
189
+ print("DEBUG: Vision training complete. Saving model and tokenizer locally...")
190
+ self.model.save_pretrained("lora_vision_model")
191
+ self.hf_tokenizer.save_pretrained("lora_vision_model")
192
+ print("DEBUG: Saved vision model and tokenizer to 'lora_vision_model'.")
193
+
194
+ def vision_inference(self, instruction, image):
195
+ FastVisionModel.for_inference(self.model)
196
+ messages = [
197
+ {"role": "user", "content": [
198
+ {"type": "image"},
199
+ {"type": "text", "text": instruction}
200
+ ]}
201
+ ]
202
+ input_text = self.hf_tokenizer.apply_chat_template(messages, add_generation_prompt=True)
203
+ inputs = self.hf_tokenizer(
204
+ image,
205
+ input_text,
206
+ add_special_tokens=False,
207
+ return_tensors="pt"
208
+ ).to("cuda")
209
+ outputs = self.model.generate(
210
+ **inputs,
211
+ max_new_tokens=128,
212
+ use_cache=True,
213
+ temperature=1.5,
214
+ min_p=0.1
215
+ )
216
+ print("DEBUG: Vision inference output:", self.hf_tokenizer.batch_decode(outputs))
217
+
218
+ def save_model_merged(self):
219
+ if os.path.exists(self.config["hf_model_name"]):
220
+ shutil.rmtree(self.config["hf_model_name"])
221
+ self.model.push_to_hub_merged(
222
+ self.config["hf_model_name"],
223
+ self.hf_tokenizer,
224
+ save_method="merged_16bit",
225
+ token=os.getenv("HF_TOKEN")
226
+ )
227
+
228
+ def push_model_gguf(self):
229
+ self.model.push_to_hub_gguf(
230
+ self.config["hf_model_name"],
231
+ self.hf_tokenizer,
232
+ quantization_method=self.config.get("quantization_method", "q4_k_m"),
233
+ token=os.getenv("HF_TOKEN")
234
+ )
235
+
236
+ def save_model_gguf(self):
237
+ self.model.save_pretrained_gguf(
238
+ self.config["hf_model_name"],
239
+ self.hf_tokenizer,
240
+ quantization_method="q4_k_m"
241
+ )
242
+
243
+ def prepare_modelfile_content(self):
244
+ output_model = self.config["hf_model_name"]
245
+
246
+ template = '''{{- range $index, $_ := .Messages }}<|start_header_id|>{{ .Role }}<|end_header_id|>
247
+
248
+ {{ .Content }}
249
+ {{- if gt (len (slice $.Messages $index)) 1 }}<|eot_id|>
250
+ {{- else if ne .Role "assistant" }}<|eot_id|><|start_header_id|>assistant<|end_header_id|>
251
+
252
+ {{ end }}
253
+ {{- end }}'''
254
+
255
+ return f"""FROM {output_model}
256
+ TEMPLATE {template}
257
+ PARAMETER temperature 0.6
258
+ PARAMETER top_p 0.9
259
+ """
260
+
261
+ def create_and_push_ollama_model(self):
262
+ modelfile_content = self.prepare_modelfile_content()
263
+ with open("Modelfile", "w") as file:
264
+ file.write(modelfile_content)
265
+ subprocess.run(["ollama", "serve"])
266
+ subprocess.run(["ollama", "create", f"{self.config['ollama_model']}:{self.config['model_parameters']}", "-f", "Modelfile"])
267
+ subprocess.run(["ollama", "push", f"{self.config['ollama_model']}:{self.config['model_parameters']}"])
268
+
269
+ def run(self):
270
+ self.print_system_info()
271
+ self.check_gpu()
272
+ self.check_ram()
273
+ if self.config.get("train", "true").lower() == "true":
274
+ self.prepare_model()
275
+ self.train_model()
276
+ if self.config.get("huggingface_save", "true").lower() == "true":
277
+ self.save_model_merged()
278
+ if self.config.get("huggingface_save_gguf", "true").lower() == "true":
279
+ self.push_model_gguf()
280
+ if self.config.get("ollama_save", "true").lower() == "true":
281
+ self.create_and_push_ollama_model()
282
+
283
+
284
+ def main():
285
+ import argparse
286
+ parser = argparse.ArgumentParser(description="PraisonAI Vision Training Script")
287
+ parser.add_argument("command", choices=["train", "inference"], help="Command to execute")
288
+ parser.add_argument("--config", default="config.yaml", help="Path to configuration file")
289
+ args = parser.parse_args()
290
+
291
+ trainer_obj = TrainVisionModel(config_path=args.config)
292
+ if args.command == "train":
293
+ trainer_obj.run()
294
+ elif args.command == "inference":
295
+ # For inference, we load a sample image from the first dataset
296
+ instr = trainer_obj.config.get("vision_instruction", "You are an expert radiographer. Describe accurately what you see in this image.")
297
+ ds_info = trainer_obj.config["dataset"][0]
298
+ ds = load_dataset(ds_info["name"], split=ds_info.get("split_type", "train"))
299
+ sample_image = ds[0]["image"]
300
+ if trainer_obj.model is None or trainer_obj.hf_tokenizer is None:
301
+ trainer_obj.prepare_model()
302
+ trainer_obj.vision_inference(instr, sample_image)
303
+
304
+
305
+ if __name__ == "__main__":
306
+ main()