LTX-2.5 XPLDV exploded-view LoRA: weights, model card, examples and workflow

.gitattributes

@@ -33,3 +33,8 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+*.webp filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,580 @@
+LTX-2.x Community License Agreement
+License date: August 11, 2026
+
+
+By downloading, using, accessing or distributing any portion or
+element of LTX-2.x, you agree that you have read and accepted to be
+bound by this Agreement.
+
+1. Definitions
+
+1.1 "Agreement" means the terms and conditions for this LTX-2.x
+Community License Agreement and the exhibits, attachments, and
+Complementary Materials, as specified in this document.
+
+1.2 "Complementary Materials" means the accompanying
+documentation, tutorials, examples, configuration files and
+other materials made available by Licensor together with the
+LTX-2.x model weights and parameters, in each case as
+distributed by Licensor.
+
+1.3 "Control" means the direct or indirect ownership of more than
+fifty percent (50%) of the voting securities or other
+ownership interests, or the power to direct the management and
+policies of such Entity through voting rights, contract, or
+otherwise.
+
+1.4 "Data" means a collection of information and/or content
+extracted from the dataset used with LTX-2.x, including to
+train, pretrain, or otherwise evaluate LTX-2.x. The Data is
+not licensed under this Agreement.
+
+1.5 "Derivatives of LTX-2.x" means all modifications to LTX-2.x,
+works based on LTX-2.x, or any other model which is created or
+initialized by transfer of patterns of the weights,
+parameters, activations or output of LTX-2.x, to the other
+model, in order to cause the other model to perform similarly
+to LTX-2.x, including - but not limited to - distillation
+methods entailing the use of intermediate data representations
+or methods based on the generation of synthetic data by
+LTX-2.x for training the other model. For clarity, Derivatives
+of LTX-2.x include: (i) any fine-tuned or adapted weights,
+parameters, or checkpoints derived from LTX-2.x; (ii)
+derivative model architectures that incorporate or are based
+upon LTX-2.x's architecture; and (iii) any modified or
+extended versions of the Complementary Materials.
+
+1.6 "Entity" means any individual, corporation, partnership,
+limited liability company, or other legal entity. For purposes
+of this Agreement, an Entity shall be deemed to include, on an
+aggregative basis, all subsidiaries, affiliates, and other
+companies under common Control with such Entity. When
+determining whether an Entity meets any threshold under this
+Agreement (including revenue thresholds in Section 2.1), all
+subsidiaries, affiliates, and companies under common Control
+shall be considered collectively.
+
+1.7 "Harm" includes but is not limited to physical, mental,
+psychological, financial and reputational damage, pain, or
+loss.
+
+1.8 "Licensor" or "LTX" means the owner that is granting the
+license under this Agreement. For the purposes of this
+Agreement, the Licensor is Lightricks Ltd.
+
+1.9 "LTX-2.x" means the large generative models,
+text/image/video/audio/3D generation models, and multimodal
+large language models and their software and algorithms,
+including trained model weights, parameters (including
+optimizer states), machine-learning model code,
+inference-enabling code, training-enabling code, fine-tuning
+enabling code, accompanying source code, scripts, and all
+other elements of the foregoing distributed and made publicly
+available by LTX (including, for example, at
+https://github.com/Lightricks/LTX-2). This license is
+applicable to all LTX-2.5 versions released since August 11,
+2026, and all future releases of LTX-2.x under this license.
+
+1.10 "Output" means the results of operating LTX-2.x as embodied
+in informational content resulting therefrom.
+
+1.11 "you" (or "your") means an individual or legal Entity
+licensing LTX-2.x in accordance with this Agreement and/or
+otherwise downloading, accessing, distributing or using
+LTX-2.x for whichever purpose and in any field of use,
+including usage of LTX-2.x in an end-use application - e.g.
+chatbot, translator, image generator.
+
+2. Grant of License.
+
+2.1 Subject to your compliance with the terms and conditions of
+this Agreement, you are granted a non-exclusive, worldwide,
+non-transferable and royalty-free limited license under
+Licensor's intellectual property or other rights owned by
+Licensor embodied in LTX-2.x to use, reproduce, prepare,
+distribute, publicly display, publicly perform, sublicense,
+copy, create derivative works of, and make modifications to
+LTX-2.x, for any purpose, subject to the restrictions set
+forth in Attachment A; provided however, that Entities with
+annual revenues of at least $10,000,000 (the "Commercial
+Entities") are required to obtain a paid license for any use
+(excluding use solely for a Non-Commercial Purpose as set
+forth in Section 2.2) of LTX-2.x and Derivatives of LTX-2.x
+(such paid license referred to herein as a "Commercial Use
+Agreement"), as will be provided by the Licensor. Commercial
+Entities interested in such a commercial license are required
+to contact Licensor (ltxv-licensing@lightricks.com). Any use
+of LTX-2.x or Derivatives of LTX-2.x by Commercial Entities
+not in accordance with this Agreement and/or the Commercial
+Use Agreement is strictly prohibited and shall be deemed a
+material breach of this Agreement. In the event of such
+material breach, and without limiting Licensor's right to
+terminate the Agreement or to pursue any other remedies
+available at law or in equity, you shall pay Licensor the
+license fees owed for the period such Commercial Entity used
+LTX-2.x (calculated at Licensor's standard commercial license
+fees, in effect during the relevant period or, absent
+published standard fees, a reasonable market rate for a
+comparable license), within thirty (30) days of Licensor's
+written demand.
+
+2.2 Notwithstanding the foregoing or anything to the contrary in
+this Agreement, a Commercial Entity may download and use
+LTX-2.x and Derivatives of LTX-2.x without obtaining the
+Commercial Use Agreement solely for a Non-Commercial Purpose.
+"Non-Commercial Purpose" means any of the following uses, but
+only so far as such Commercial Entity does not receive any
+direct or indirect payment arising from the use of LTX-2.x or
+Derivatives of LTX-2.x: (i) use by an individual acting in a
+personal capacity for research, experimentation, learning,
+private study, hobby or recreational projects, or personal
+entertainment, in each case where such use is not connected,
+directly or indirectly, to any commercial activity, business
+operation, or the performance of duties for an employer or any
+other Entity; and (ii) use by a Commercial Entity for testing,
+evaluation, or non-commercial research and development in a
+non-production or development environment. For clarity, use
+(a) for revenue-generating activity in any manner, whether
+direct or indirect, (b) in direct interactions with or that
+has impact on end users, or (c) to train, fine-tune, or
+distill any model (including any Derivative of LTX-2.x) for
+commercial use, in each case, is not a Non-Commercial Purpose
+and requires all Commercial Entities to obtain a paid license
+under the Commercial Use Agreement prior to such use. For the
+avoidance of doubt, the permission granted under this Section
+2.2 is a limited right of use only and does not convey or
+transfer any ownership right, title, or interest in or to
+LTX-2.x or any Derivatives of LTX-2.x, and all Derivatives of
+LTX-2.x created or used pursuant to this Section 2.2 remain
+subject to the terms of this Agreement, including Section 1.5.
+
+3. Distribution and Redistribution. You may host for third parties
+remote access purposes (e.g. software-as-a-service), reproduce and
+distribute copies of LTX-2.x or Derivatives of LTX-2.x thereof in
+any medium, with or without modifications, provided that you meet
+the following conditions:
+
+3.1 Use-based restrictions as referenced in Section 4 and all
+provisions of Attachment A MUST be included as an enforceable
+provision by you in any type of legal agreement (e.g. a
+license) governing the use and/or distribution of LTX-2.x or
+Derivatives of LTX-2.x, and you shall give notice to
+subsequent users you distribute to, that LTX-2.x or
+Derivatives of LTX-2.x are subject to Section 4 and Attachment
+A in their entirety, including all use restrictions and
+acceptable use policies;
+
+3.2 You must provide any third-party recipients of LTX-2.x or
+Derivatives of LTX-2.x a copy of this Agreement, including all
+attachments and use policies. Any Derivative of LTX-2.x (as
+defined in Section 1.5, including but not limited to
+fine-tuned weights, modified training code, models trained on
+Outputs, or any other derivative) must be distributed
+exclusively under the terms of this Agreement, subject to
+Section 3.6, with a complete copy of this Agreement included;
+
+3.3 You must cause any modified files to carry prominent notices
+stating that you changed the files;
+
+3.4 You must retain all copyright, patent, trademark, and
+attribution notices excluding those notices that do not
+pertain to any part of LTX-2.x, Derivatives of LTX-2.x.
+
+3.5 Transfer of Derivatives. No transfer of any Derivative of
+LTX-2.x (including any fine-tuned weights, LoRA adapters, or
+similar adaptations) to a third party shall grant such third
+party any right, title, license, or authorization to access,
+use, reproduce, distribute, or exploit LTX-2.x, or any
+Derivative of LTX-2.x beyond the rights granted under this
+Agreement. If the transferee is a Commercial Entity (as
+defined in Section 2), it must obtain a paid license from
+Licensor prior to any use of any Derivative of LTX-2.x,
+regardless of who created such Derivative. Prior to or at the
+time of any such transfer, you shall notify the transferee in
+writing that (i) use of such Derivative of LTX-2.x is subject
+to the terms of this Agreement, and (ii) if the transferee is
+a Commercial Entity, it must obtain a separate paid license to
+LTX-2.x from Licensor. You shall not transfer any Derivative
+of LTX-2.x to a Commercial Entity unless such Commercial
+Entity has obtained the required paid license from Licensor
+prior to any use, and unless the proposed transferee has been
+so informed. You and the transferee shall each be responsible
+for ensuring the transferee obtains the required license from
+Licensor prior to any use of LTX-2.x or Derivative of LTX-2.x.
+Nothing in this Section 3.5 shall require a Commercial Entity
+to obtain a paid license for use solely for a Non-Commercial
+Purpose as permitted under Section 2.2.
+
+3.6 You may add your own copyright statement to your modifications
+and may provide additional license terms and conditions -
+respecting Section 3.1 - for use, reproduction, or
+distribution of your modifications, or for any such
+Derivatives of LTX-2.x as a whole, provided your use,
+reproduction, and distribution of LTX-2.x otherwise complies
+with the conditions stated in this Agreement, and you provide
+a complete copy of this Agreement with any such use,
+reproduction and distribution of LTX-2.x and any Derivatives
+thereof; provided that any such additional terms shall be
+additive only and shall not derogate from, conflict with,
+waive, or purport to modify any term of this Agreement, and
+this Agreement shall govern in the event of any conflict.
+
+4. Use-based restrictions. The restrictions set forth in Attachment A
+are considered Use-based restrictions. Therefore, you cannot use
+LTX-2.x and the Derivatives of LTX-2.x in violation of the
+specified restricted uses. You may use LTX-2.x subject to this
+Agreement, only for lawful purposes and in accordance with the
+Agreement. "Use" may include creating any content with,
+fine-tuning, updating, running, training, evaluating and/or
+re-parametrizing LTX-2.x. You shall require all of your users who
+use LTX-2.x or a Derivative of LTX-2.x to comply with the terms of
+this Section 4.
+
+5. The Output You Generate. Except as set forth herein, Licensor
+claims no rights in the Output you generate using LTX-2.x. You are
+accountable for input you insert into LTX-2.x, the Output you
+generate and its subsequent uses. No use of the Output can
+contravene any provision as stated in the Agreement.
+
+6. Updates and Runtime Restrictions; AI Regulations. To the maximum
+extent permitted by law, Licensor reserves the right to restrict
+(remotely or otherwise) usage of LTX-2.x in violation of this
+Agreement, update LTX-2.x through electronic means, or modify the
+Output of LTX-2.x based on updates. You shall undertake reasonable
+efforts to use the latest version of LTX-2.x. Any use of the
+non-current version of LTX-2.x is done solely at your risk. To the
+extent applicable to you, you shall comply with all laws and
+regulations governing artificial intelligence that apply to your
+use, deployment, or distribution of LTX-2.x, Derivatives of
+LTX-2.x, or Outputs, including Regulation (EU) 2024/1689 (the "EU
+AI Act") and the California AI Transparency Act (Cal. Bus. & Prof.
+Code § 22757 et seq.), each as amended from time to time and any
+other applicable laws, regulations, or binding guidance relating
+to artificial intelligence, transparency, content provenance, or
+synthetic media, together with any documentation made available by
+Licensor regarding compliance with the same (collectively, "AI
+Regulations"). You shall maintain (including within any
+application or service through which LTX-2.x, any Derivative of
+LTX-2.x, or any Output is made available), and shall not remove,
+disable, alter, or circumvent, any safety or security measures,
+disclosures, metadata, watermarking, content provenance, latent
+disclosure, or other transparency features or functionalities
+included or embedded within LTX-2.x or any Derivative of LTX-2.x,
+or applied to any Output, in furtherance of AI Regulations,
+including any capability of LTX-2.x to include latent disclosures
+in Outputs, and you shall include equivalent obligations in any
+agreement governing your distribution of LTX-2.x or any Derivative
+of LTX-2.x. You are solely responsible for any transparency,
+disclosure, marking, or labeling obligations applicable to you
+under AI Regulations as a provider or deployer of LTX-2.x, any
+Derivative of LTX-2.x, or any system incorporating any of the
+foregoing, including any obligation to disclose that content is
+artificially generated or manipulated. If Licensor knows or
+reasonably believes that you have modified LTX-2.x or any
+Derivative of LTX-2.x such that it is no longer capable of
+including any disclosure required by AI Regulations in Outputs, or
+that you have otherwise removed, disabled, or circumvented any
+feature or functionality described in this Section, Licensor may
+in its sole discretion revoke the license granted under this
+Agreement effective immediately upon notice to you, and upon such
+revocation you shall immediately cease all use of LTX-2.x and
+Derivatives of LTX-2.x. Licensor makes no representation or
+warranty that LTX-2.x, any Derivative of LTX-2.x, or any Output
+complies with any AI Regulations applicable to your specific use
+case or deployment, and you are solely responsible for determining
+the applicability of, and ensuring your compliance with, all AI
+Regulations. You shall indemnify, defend, and hold harmless
+Licensor and its affiliates from and against any and all claims,
+liabilities, losses, damages, costs, and expenses (including
+reasonable attorneys' fees) arising out of or relating to your
+use, deployment, distribution, or modification of LTX-2.x, any
+Derivative of LTX-2.x, or any Output in violation of, or your
+other failure to comply with, any AI Regulations.
+
+For purposes of the EU AI Act, Licensor makes LTX-2.x openly
+available under this community license and intends that LTX-2.x be
+treated as a free and open-source general purpose AI model within
+the meaning of Article 53(2) of the EU AI Act. You acknowledge and
+agree that (a) to the extent the free and open source derogations
+under Article 53(2) of the EU AI Act apply, Licensor's obligations
+under the EU AI Act with respect to LTX-2.x are limited to those
+applicable to providers of free and open source general purpose AI
+models (it being acknowledged that such derogations do not extend
+to the obligations under Article 53(1)(c) and (d)), (b) you
+acknowledge that LTX-2.x is not intended to be integrated into a
+high risk AI system, and shall be fully and solely responsible for
+any obligation resulting from such integration, (c) if you
+integrate LTX-2.x or any Derivative of LTX-2.x into a high-risk AI
+system you shall be solely responsible for all provider
+obligations that would otherwise apply to Licensor under the EU AI
+Act, and (d) you shall not take any action, or omit to take any
+action, that would cause Licensor to lose the benefit of the free
+and open source derogations under the EU AI Act, and you shall
+indemnify and hold Licensor harmless from any liability, costs, or
+expenses arising from your breach of this Section.
+
+7. Export Controls and Sanctions Compliance. You acknowledge that
+LTX-2.x, Derivatives of LTX-2.x may be subject to export control
+laws and regulations, including but not limited to the U.S. Export
+Administration Regulations and sanctions programs administered by
+the Office of Foreign Assets Control (OFAC). You represent and
+warrant that you and any users of LTX-2.x are not (i) located in,
+organized under the laws of, or ordinarily resident in any country
+or territory subject to comprehensive sanctions; (ii) identified
+on any U.S. government restricted party list, including the
+Specially Designated Nationals and Blocked Persons List; or (iii)
+otherwise prohibited from receiving LTX-2.x under applicable law.
+You shall not export, re-export, or transfer LTX-2.x, directly or
+indirectly, in violation of any applicable export control or
+sanctions laws or regulations. You agree to comply with all
+applicable trade control laws and shall indemnify and hold
+Licensor harmless from any claims arising from your failure to
+comply with such laws.
+
+8. Trademarks; Reservation of Rights. Nothing in this Agreement
+permits you to make use of Licensor's trademarks, trade names,
+logos or to otherwise suggest endorsement or misrepresent the
+relationship between the parties; and any rights not expressly
+granted herein are reserved by the Licensor. Except as expressly
+set forth in this Agreement, Licensor does not grant, directly or
+by implication, estoppel, statute or otherwise, any right or
+license in its, or its affiliates', intellectual property rights
+or other proprietary rights. For avoidance of doubt, all
+intellectual property rights in Derivatives of LTX-2.x shall be
+subject to the terms of this Agreement, and you acquire no right,
+title, or interest in or to LTX-2.x itself, which is and remains
+the exclusive property of Licensor. You shall not assert any
+ownership or other right in LTX-2.x or any Derivative of LTX-2.x
+in any manner that restricts, encumbers, or is inconsistent with
+the rights retained by Licensor or granted to other licensees
+under this Agreement.
+
+9. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides LTX-2.x on an "AS IS"
+BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied, including, without limitation, any warranties
+or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or
+FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for
+determining the appropriateness of using or redistributing LTX-2.x
+and Derivatives of LTX-2.x and assume any risks associated with
+your exercise of permissions under this Agreement.
+
+10. Limitation of Liability. To the fullest extent permitted by
+applicable law, in no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless
+required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall Licensor be liable
+to you or any other individual or Entity for damages, including
+any direct, indirect, special, incidental, or consequential
+damages of any character arising as a result of this Agreement or
+out of the use of, or inability to use LTX-2.x or any Derivative
+of LTX-2.x (including but not limited to damages for loss of
+goodwill, work stoppage, computer failure or malfunction, or any
+and all other commercial damages or losses), even if Licensor has
+been advised of the possibility of such damages.
+
+11. Accepting Warranty or Additional Liability. While redistributing
+LTX-2.x and Derivatives of LTX-2.x, you may, provided you do not
+violate the terms of this Agreement, choose to offer and charge a
+fee for, acceptance of support, warranty, indemnity, or other
+liability obligations. However, in accepting such obligations,
+you may act only on your own behalf and on your sole
+responsibility, not on behalf of Licensor, and only if you agree
+to indemnify, defend, and hold Licensor harmless for any
+liability incurred by, or claims asserted against Licensor, by
+reason of your accepting any such warranty or additional
+liability.
+
+12. Governing Law. This Agreement and all relations, disputes, claims
+and other matters arising hereunder (including non-contractual
+disputes or claims) will be governed exclusively by, and
+construed exclusively in accordance with, the laws of the State
+of New York and applicable U.S. federal law. To the extent
+permitted by law, choice of laws rules and the United Nations
+Convention on Contracts for the International Sale of Goods will
+not apply. The prevailing party in any claim or dispute between
+the parties under this Agreement will be entitled to
+reimbursement of its reasonable attorneys' fees and costs.
+
+13. Term and Termination. This Agreement is effective upon your
+acceptance and continues until terminated. Licensor may terminate
+this Agreement immediately upon written notice to you if you
+breach any provision of this Agreement, including but not limited
+to violations of the use restrictions in Attachment A or
+unauthorized commercial use. This Agreement also terminates
+immediately and automatically, without notice, upon any material
+breach of this Agreement, including any use in violation of
+applicable AI Regulations or any unauthorized commercial use of
+LTX-2.x or Derivatives of LTX-2.x by a Commercial Entity. Upon
+termination: (a) all rights granted to you under this Agreement
+will immediately cease; (b) you must immediately cease all use of
+LTX-2.x and Derivatives of LTX-2.x; (c) you must delete or
+destroy all copies of LTX-2.x and Derivatives of LTX-2.x in your
+possession or control; and (d) you must notify any third parties
+to whom you distributed LTX-2.x or Derivatives of LTX-2.x of the
+termination. Sections 2, 3, 4, 6-16 and Attachment A shall
+survive termination of this Agreement. Termination does not
+relieve you of any obligations incurred prior to termination,
+including payment obligations under Section 2 and adhering to the
+restrictions under Section 3. In addition, if You commence a
+lawsuit or other proceedings (including a cross-claim or
+counterclaim in a lawsuit) against Licensor or any person or
+entity alleging that LTX-2.x or any Output, or any portion of any
+of the foregoing, infringe any intellectual property or other
+right owned or licensable by you, then all licenses granted to
+you under this Agreement shall terminate as of the date such
+lawsuit or other proceeding is filed.
+
+14. Disputes and Arbitration; Waiver of Jury Trial; Class Action
+Waiver. IF YOU ARE NOT ACTING AS A CONSUMER UNDER APPLICABLE LAW,
+YOU HEREBY WAIVE THE RIGHT TO A TRIAL BY JURY, TO PARTICIPATE IN
+A CLASS OR REPRESENTATIVE ACTION (INCLUDING IN ARBITRATION), OR
+TO COMBINE INDIVIDUAL PROCEEDINGS IN COURT OR IN ARBITRATION
+WITHOUT THE CONSENT OF ALL PARTIES. All disputes arising in
+connection with this Agreement shall be finally settled by
+arbitration under the Rules of Arbitration of the International
+Chamber of Commerce ("ICC Rules"), by one (1) arbitrator
+appointed in accordance with the ICC Rules. The seat of
+arbitration shall be New York, NY, USA, and the proceedings shall
+be conducted in English. The arbitrator shall be empowered to
+grant any relief that a court could grant. Judgment on the
+arbitration award may be entered by any court having jurisdiction
+thereof. Notwithstanding the foregoing, either party may seek
+injunctive or other equitable relief in respect of any actual or
+threatened breach of the license restrictions under this
+Agreement (including Attachment A and the Acceptable Use Policy)
+or any actual or threatened infringement, misappropriation, or
+violation of Licensor's intellectual property rights, in the
+state or federal courts located in the County of New York, State
+of New York, and each party irrevocably consents to the
+jurisdiction of, and venue in, such courts for that limited
+purpose. The foregoing waivers do not apply to, and are not
+enforceable against, any licensee acting as a consumer under the
+mandatory consumer-protection laws of its jurisdiction of
+residence (including, without limitation, the European Union, the
+United Kingdom, and the State of California), and nothing in this
+Agreement limits any rights under such laws that cannot be waived
+or limited by contract. If any waiver in this Section is held
+invalid or unenforceable as to a particular licensee or dispute,
+such waiver shall be severed to that extent only and shall not
+affect the validity or enforceability of the remainder of this
+Section.
+
+15. In the event of any exception to the application of binding
+arbitration, all disputes, claims, and other matters arising
+hereunder shall be brought exclusively in the state or federal
+courts located in the County of New York, State of New York. You
+waive all defenses of lack of personal jurisdiction and forum non
+conveniens with respect to venue and jurisdiction in such courts,
+and consent to their exclusive jurisdiction and venue.
+
+16. Severability. If any provision of this Agreement is held to be
+invalid, illegal or unenforceable, the remaining provisions shall
+be unaffected thereby and remain valid as if such provision had
+not been set forth herein.
+
+ END OF TERMS AND CONDITIONS
+
+         Attachment A
+       Use Restrictions
+
+When using the Outputs, LTX-2.x and any Derivatives thereof, you
+agree to comply with the Acceptable Use Policy
+(https://static.lightricks.com/legal/ltx-acceptable-use-policy.pdf)
+which is hereby incorporated into and made part of this Agreement by
+reference. Licensor may update it from time to time, and the version
+in effect at the time of your use governs; continued use after an
+update constitutes acceptance. Licensor shall post each version of
+the Acceptable Use Policy with its effective date, and no update
+shall apply retroactively to use occurring before that effective
+date. In addition, you agree not to use the Outputs, LTX-2.x or its
+Derivatives in any of the following ways:
+
+1) In any way that violates any applicable national, federal,
+state, local or international law or regulation;
+
+2) For the purpose of exploiting, Harming or attempting to exploit
+or Harm minors in any way;
+
+3) Knowingly generate or disseminate verifiably false information
+and/or content with the intent to deceive, defraud, or
+otherwise unlawfully Harm others;
+
+4) To generate or disseminate personal identifiable information
+that can be used to Harm an individual;
+
+5) To generate or disseminate information and/or content (e.g.
+images, code, posts, articles), and place the information
+and/or content in any context (e.g. bot generating tweets)
+without expressly and intelligibly disclaiming that the
+information and/or content is machine generated;
+
+6) To defame others, or to engage in the unlawful harassment of
+others;
+
+7) To impersonate or attempt to impersonate (e.g. deepfakes)
+others without their consent;
+
+8) For fully automated decision making that adversely impacts an
+individual's legal rights or otherwise creates or modifies a
+binding, enforceable obligation;
+
+9) For any use intended to or which has the effect of
+discriminating against or Harming individuals or groups based
+on online or offline social behavior or known or predicted
+personal or personality characteristics;
+
+10) To exploit any of the vulnerabilities of a specific group of
+persons based on their age, social, physical or mental
+characteristics, in order to materially distort the behavior
+of a person pertaining to that group in a manner that causes
+or is likely to cause that person or another person physical
+or psychological Harm;
+
+11) For any use intended to or which has the effect of
+discriminating against individuals or groups based on legally
+protected characteristics or categories;
+
+12) To provide medical advice and medical results interpretation;
+
+13) To generate or disseminate information for the purpose to be
+used for administration of justice, law enforcement,
+immigration or asylum processes, such as predicting an
+individual will commit fraud/crime commitment (e.g. by text
+profiling, drawing causal relationships between assertions
+made in documents, indiscriminate and arbitrarily-targeted
+use);
+
+14) To generate and/or disseminate malware (including - but not
+limited to - ransomware) or any other content to be used for
+the purpose of harming electronic systems;
+
+15) To engage in, promote, incite, or facilitate discrimination or
+other unlawful or harmful conduct in the provision of
+employment, employment benefits, credit, housing, or other
+essential goods and services;
+
+16) To engage in, promote, incite, or facilitate the harassment,
+abuse, threatening, or bullying of individuals or groups of
+individuals;
+
+17) For military, warfare, nuclear industries or applications,
+weapons development, or any use in connection with activities
+that may cause death, personal injury, or severe physical or
+environmental damage;
+
+18) For commercial use only: To train, improve, or fine-tune any
+other machine learning model, artificial intelligence system,
+or competing model, except for Derivatives of LTX-2.x as
+expressly permitted under this Agreement;
+
+19) To circumvent, disable, or interfere with any technical
+limitations, safety features, content filters, watermarking,
+content provenance or latent disclosure functionalities, or
+use restrictions implemented in LTX-2.x by Licensor;
+
+20) To use LTX-2.x or Derivatives of LTX-2.x in any product,
+service, or application that directly competes with Licensor's
+commercial products or services, or is designed to replace or
+substitute Licensor's offerings in the market, without
+obtaining a separate commercial license from Licensor.

README.md

@@ -0,0 +1,180 @@
+---
+license: other
+license_name: ltx-2.x-community-license-agreement
+license_link: LICENSE
+base_model: Lightricks/LTX-2.5
+base_model_relation: adapter
+pipeline_tag: image-to-video
+language:
+- en
+tags:
+- ltx-2.5
+- ltx-video
+- lora
+- image-to-video
+- video-generation
+- comfyui
+- exploded-view
+- xpldv
+widget:
+  - text: "An open laptop separates into an ordered exploded view while resting stationary on the wooden table. The complete display assembly lifts free of its hinge mounts and translates upward and backward, keeping the screen, bezel and rear cover together at the original open angle, with a clear air gap between the display and the rear edge of the base. The entire keyboard and trackpad deck, including all keys and the palm rest, detaches and translates straight upward as one flat horizontal assembly. It rises high above the lower case, exposing the circuit board and cooling system toward the back and the flat battery pack beneath the palm rest. These exterior parts move first and travel furthest, leaving generous open gaps around the internal assemblies. One compact circuit board with its chips, cooling fans and metal heat pipes rises beneath the keyboard deck, with all of these components remaining mounted together as a single assembly. The flat dark battery cells remain joined as one battery pack and translate upward and slightly forward from the front portion of the lower case, exposing the shallow battery compartment and mounting points underneath. The remaining lower case is one empty shallow metal tray resting on the tabletop. The raised keyboard deck, circuit board and battery pack occupy three separate horizontal levels with broad bands of open air between them; the upright display is positioned behind the stack and the empty lower tray stays beneath it. Each of the five major assemblies retains its original shape as the layers settle into an organized arrangement and hold steady. The camera slowly orbits to the right around the laptop from the starting three-quarter view, keeping the full expanded arrangement visible. The soft daylight remains consistent throughout one continuous shot."
+    example_title: "Laptop · COMPLEX"
+    output:
+      url: examples/xpldv_laptop.mp4
+  - text: "The desktop computer tower separates into an ordered exploded view. The glass side panel, front panel, top cover and lower power-supply cover move outward along controlled paths, revealing the motherboard, graphics card, liquid-cooling assembly and power supply. The components separate into an organized layered arrangement around the case while retaining their original shapes. The case base stays on the desk. The camera slowly orbits to the right around the computer from the starting three-quarter view. The blue-white computer lighting and surrounding room remain consistent throughout the continuous shot."
+    example_title: "Computer · BASIC"
+    output:
+      url: examples/xpldv_computer.mp4
+  - text: "A black SUV keeps driving down the highway as it separates into an ordered exploded view. The hood and roof lift into separate horizontal layers; the four doors slide sideways; the front bumper and grille slide forward; the four wheels slide outward along their axles while spinning. These exterior parts move first and travel furthest along controlled paths, revealing the chassis, SUV V6 engine block, steering column and front and rear seats, all remaining assembled in their original positions. Each detached component keeps its shape in a clearly spaced suspended arrangement around this exposed core, and the entire arrangement travels forward together. The camera tracks alongside at matching speed as the road and guardrail flow backward continuously. Warm sunlight remains consistent."
+    example_title: "SUV · BASIC"
+    output:
+      url: examples/xpldv_suv.mp4
+  - text: "A luxury automatic mechanical wristwatch separates into an ordered exploded view while resting stationary on its dark velvet display cushion. The front sapphire crystal and surrounding polished bezel rim detach as a single unit and translate forward and slightly upward, keeping its circular orientation facing the camera. The hour, minute, and slender seconds hands lift cleanly above the dial plane, each translating upward along its own short vertical path with slight lateral spacing between them. The main dial plate carrying its applied hour markers, subdial components, and open-heart cutout details moves forward a shorter distance than the crystal, creating a clear gap between it and the hands above. These exterior parts move first and travel furthest, leaving generous gaps between each successive layer. They reveal the mechanical movement at the center of the stack—its polished bridges, interlocking gears, escapement fork, oscillating balance wheel, ruby jewels, and complication modules all visible in their assembled configuration—with the rear exhibition caseback and its oscillating automatic rotor translating backward and slightly downward as the final layer. The movement's bridges, gears, and escapement remain mounted together as a single mechanical unit. Each detached section retains its original shape as the five layers settle into an organized axial arrangement and hold steady. A slow, steady camera pull-back provides room for the full expanded stack. The soft upper-left key light, cool right-side fill, and subtle rim highlight consistent with the source image continue through one continuous shot."
+    example_title: "Watch · COMPLEX"
+    output:
+      url: examples/xpldv_watch.mp4
+  - text: "The two-story house separates into an ordered exploded view. The main roof and garage roof lift straight upward and remain suspended above the building. The front door, garage door and individual window units move forward out of their openings; the exterior wall panels slide sideways and forward away from the house. These exterior parts move first and travel furthest along controlled paths, exposing one continuous timber frame with vertical studs, horizontal beams, floor joists, roof trusses and the interior staircase. The timber frame and foundation remain assembled in their original positions. The detached roofs, wall panels, doors and windows retain their original shapes in a clearly spaced suspended arrangement around the exposed frame. The camera slowly pulls back to keep the entire arrangement visible while the dusk lighting, garden and neighboring houses remain consistent throughout the continuous shot."
+    example_title: "House · COMPLEX"
+    output:
+      url: examples/xpldv_house.mp4
+  - text: "The single-engine fighter jet separates into an ordered exploded view while its landing gear remains planted on the runway. The nose radome slides straight forward along the aircraft centreline, revealing a circular radar antenna in the nose and compact avionics boxes immediately behind it. The clear canopy lifts upward, exposing the single ejection seat and instrument panel in the cockpit. Upper fuselage skin panels rise in separate sections, and the two wing assemblies translate sideways while remaining level. These exterior components move first and travel furthest, opening clear gaps around the internal airframe. One cylindrical turbofan engine remains mounted lengthwise in the central rear fuselage behind the cockpit, with metallic compressor casing and turbine sections visible. The cockpit, intake duct, fuselage ribs and landing-gear supports stay assembled in their original positions. Each detached section retains its shape as the arrangement settles and holds steady. The camera slowly pulls back in the original three-quarter view, keeping the whole aircraft visible under consistent sunset light."
+    example_title: "Fighter jet · COMPLEX"
+    output:
+      url: examples/xpldv_jet.mp4
+---
+
+# XPLDV — Exploded-View LoRA for LTX-2.5
+
+Turn a source image into an animated exploded view. XPLDV separates an object's exterior parts to reveal the components underneath, for product showcases, mechanical reveals, architectural breakdowns, and stylized cutaways.
+
+[Download LoRA](ltx-2.5-xpldv_v5-lora.safetensors) · [ComfyUI workflow](workflows/ltx-2.5_distilled_xpldv_example_workflow.json) · [Prompt guide](prompt_guide.md)
+
+## How it works
+
+1. Load the included workflow and select your starting image and installed model files.
+2. Describe which parts separate, what they reveal, and how the camera moves.
+3. Generate the video with XPLDV at strength **0.5**.
+
+XPLDV works best with `ltx-2.5-22b-distilled-transformer-bf16.safetensors`. It can also be used with `ltx-2.5-22b-dev-transformer-bf16.safetensors`, which it was trained on. The included workflow uses the distilled model. Base models: [Lightricks/LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5).
+
+## Featured videos
+
+Six 10-second examples using XPLDV at strength **0.5**. Each video includes its exact prompt.
+
+<Gallery />
+
+<details>
+<summary>With and without XPLDV</summary>
+
+Matched comparisons using the same image, prompt, seed, and settings. Comparison videos are silent.
+
+[Laptop](examples/comparisons/comparison_laptop.mp4) · [Computer](examples/comparisons/comparison_computer.mp4) · [SUV](examples/comparisons/comparison_suv.mp4) · [Watch](examples/comparisons/comparison_watch.mp4) · [House](examples/comparisons/comparison_house.mp4) · [Fighter jet](examples/comparisons/comparison_jet.mp4)
+
+</details>
+
+## Recommended settings
+
+**Start with LoRA strength 0.5.**
+
+| Setting | Recommended value |
+| --- | --- |
+| CFG | 1 in both stages |
+| Duration | 10 seconds: 241 frames at 24 FPS |
+| First stage | 960 × 544; Euler ancestral; 8 steps |
+| Second stage | 1920 × 1088; Euler; 3 steps |
+| Second-stage manual sigmas | `0.85, 0.7250, 0.4219, 0.0` |
+| Image conditioning | 0.7 in the first stage; 1.0 in the second |
+| Prompt enhancement | Off |
+| Negative prompt | Empty |
+| Seed for comparisons | 42 in both stages |
+
+The workflow includes these settings and applies the LoRA to both stages. The manual sigmas above belong in **Upscale and re-sampler (3 steps)**; keep the first-stage schedule unchanged.
+
+<details>
+<summary>LoRA strength</summary>
+
+These are observed tendencies from the tests, not fixed rules for every subject.
+
+| LoRA strength | Observed behavior |
+| --- | --- |
+| **0.5** | Recommended balance of separation, shape, and detail. |
+| **0.75** | Stronger influence; can improve separation, but may simplify detail or repeat parts. |
+
+Change one setting at a time while keeping the image, prompt, and seed fixed.
+</details>
+
+## Prompting
+
+No trigger word is required. Name the parts that move, the components revealed underneath, and anything that stays connected. Write one continuous paragraph.
+
+### BASIC template — a short, readable reveal
+
+```text
+[SUBJECT] separates into an ordered exploded view. [NAMED OUTER PARTS] move outward along controlled paths, revealing [NAMED INTERNAL COMPONENTS] underneath. The parts settle into an organized [LAYERED / RADIAL] arrangement around [EXPOSED CORE] while retaining their original shapes. [CAMERA BEHAVIOR]. [LIGHTING CONSISTENT WITH THE IMAGE] remains consistent throughout the continuous shot.
+```
+
+#### Example: Desktop PC
+
+```text
+The desktop computer tower separates into an ordered exploded view. The glass side panel, front panel, top cover and lower power-supply cover move outward along controlled paths, revealing the motherboard, graphics card, liquid-cooling assembly and power supply. The components separate into an organized layered arrangement around the case while retaining their original shapes. The case base stays on the desk. The camera slowly orbits to the right around the computer from the starting three-quarter view. The blue-white computer lighting and surrounding room remain consistent throughout the continuous shot.
+```
+
+[Watch the example](examples/xpldv_computer.mp4)
+
+### COMPLEX template — specific parts, positions, and movement paths
+
+```text
+[SUBJECT] separates into an ordered exploded view while [CONTINUING ACTION OR ANCHORED SUPPORT]. [OUTER PART A] detaches and translates [DIRECTION], keeping [ORIENTATION]. [OUTER PART B] moves [DISTINCT PATH], and [OTHER OUTER PARTS] move [PATHS]. These exterior parts move first and travel furthest, leaving clear gaps. They reveal [SPECIFIC COMPONENT AND RECOGNIZABLE FEATURES] at [POSITION RELATIVE TO THE OBJECT], with [OTHER COMPONENTS AND THEIR LOCATIONS]. [CORE COMPONENTS] remain mounted together. Each detached section retains its shape as the arrangement settles and holds steady. [CAMERA BEHAVIOR]. [CONSISTENT LIGHTING] continues through one continuous shot.
+```
+
+#### Example: Laptop
+
+```text
+An open laptop separates into an ordered exploded view while resting stationary on the wooden table. The complete display assembly lifts free of its hinge mounts and translates upward and backward, keeping the screen, bezel and rear cover together at the original open angle, with a clear air gap between the display and the rear edge of the base. The entire keyboard and trackpad deck, including all keys and the palm rest, detaches and translates straight upward as one flat horizontal assembly. It rises high above the lower case, exposing the circuit board and cooling system toward the back and the flat battery pack beneath the palm rest. These exterior parts move first and travel furthest, leaving generous open gaps around the internal assemblies. One compact circuit board with its chips, cooling fans and metal heat pipes rises beneath the keyboard deck, with all of these components remaining mounted together as a single assembly. The flat dark battery cells remain joined as one battery pack and translate upward and slightly forward from the front portion of the lower case, exposing the shallow battery compartment and mounting points underneath. The remaining lower case is one empty shallow metal tray resting on the tabletop. The raised keyboard deck, circuit board and battery pack occupy three separate horizontal levels with broad bands of open air between them; the upright display is positioned behind the stack and the empty lower tray stays beneath it. Each of the five major assemblies retains its original shape as the layers settle into an organized arrangement and hold steady. The camera slowly orbits to the right around the laptop from the starting three-quarter view, keeping the full expanded arrangement visible. The soft daylight remains consistent throughout one continuous shot.
+```
+
+[Watch the example](examples/xpldv_laptop.mp4)
+
+Replace the brackets with your subject and its parts; omit clauses that do not apply to the intended shot. Name the final arrangement: a vertical stack, a horizontal row, or a radial arrangement around the center. Use “layered” for an actual stack. Describe timing consistently: parts move at the same time or in a clear sequence. For a moving subject, keep the detached parts traveling with it. Give the camera enough room for the expanded arrangement.
+
+Audio is optional. Add sound effects, ambience, music, or dialogue in a final sentence and keep the audio pipeline connected. Audio wording can influence the visual action.
+
+See the [prompt guide](prompt_guide.md) for a short walkthrough and troubleshooting tips.
+
+## Limitations and tips
+
+- Hidden construction is imagined by the model. Detailed-looking internals may be inaccurate or misplaced.
+- Parts can merge, duplicate, bend, or lose their identity. Start with a few major assemblies and give them distinct movement paths.
+- Background objects, text, and camera framing can change. Leave room around the subject and check the full clip.
+- Review new images and seeds individually. The settings above are a starting point, and stronger LoRA influence is not always an improvement.
+
+## Training
+
+| Setting | Value |
+| --- | --- |
+| Trainer | Lightricks LTX trainer |
+| Base transformer | LTX-2.5 22B DEV BF16 |
+| Hardware | One NVIDIA RTX PRO 6000 Blackwell Workstation Edition, 96 GB VRAM |
+| LoRA rank / alpha | 64 / 64 |
+| Training steps | 4,000 |
+| Released weights | Step 3000 |
+
+### Dataset
+
+| Item | Details |
+| --- | --- |
+| Creation | Synthetic clips created in-house with Blender EEVEE Next |
+| Objects | 102 multipart objects |
+| Clips | 256 total: 204 separation clips and 52 reversed reassembly clips |
+| Resolution | 960 × 544 |
+| Length and frame rate | 121 frames at 24 FPS |
+| Arrangements | Radial, horizontal, and vertical |
+| Audio | No audio in the training clips; audio was not trained |
+
+The photographic example images were used for inference, not training. Image-to-video is the evaluated use. Training includes reassembly, but a complete separate-hold-reassemble sequence within ten seconds is not established.
+
+[Training configuration](training_config.yaml) · [Dataset summary](dataset_summary.json)
+
+## License
+
+Distributed under the included [LTX-2.x Community License Agreement](LICENSE). See [Lightricks/LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5) for the base model and its terms.

SHA256SUMS.txt

@@ -0,0 +1 @@
+37b9609b1fb25a6c39542e195779648218829d03bed0d1fa8a612ed6a3b140bf  ltx-2.5-xpldv_v5-lora.safetensors

dataset_summary.json

@@ -0,0 +1,29 @@
+{
+  "training_clips": 256,
+  "explode_clips": 204,
+  "reassembly_clips": 52,
+  "asset_identities": 102,
+  "caption_patterns": {
+    "radial": 114,
+    "horizontal": 50,
+    "vertical": 40,
+    "arc_right": 51,
+    "arc_left": 51,
+    "locked_three_quarter": 52,
+    "locked_head_on": 50,
+    "soft_light": 69,
+    "hard_light": 68,
+    "overhead_light": 67,
+    "left_framing": 24,
+    "right_framing": 24
+  },
+  "clip_metadata": {
+    "width": 960,
+    "height": 544,
+    "frames": 121,
+    "fps": 24,
+    "audio_streams": 0
+  },
+  "metadata_checked_clips": 256,
+  "adapter_parameters": 201326592
+}

examples/comparisons/comparison_computer.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5471ac3d9c1c59aa3798a38082bf48bf9c2b2fdb3b9bbbcdb851f5f748d4a389
+size 5798434

examples/comparisons/comparison_house.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1484f8a83b0ed024317462f0e154c6eb66e82786e39831593f80ad1b4e21466a
+size 7167529

examples/comparisons/comparison_jet.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f531e074c0f5f065a015834387c687e34e2ec5d8dab8870bb1057775d3d045ed
+size 3749528

examples/comparisons/comparison_laptop.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cf27673bc3d6353b3c22b5d3dcadde806ee29604d2fa72cd656749d4dfbce178
+size 4180335

examples/comparisons/comparison_suv.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:46018db36d2d4f4e0298e4c75d375e0d4b002199659e7942e049954ecb8bbb88
+size 6466525

examples/comparisons/comparison_watch.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c65178ecfb7571ae063251c2f20dac1de9d9c600386066936c7dee521ea4abcf
+size 7039419

examples/xpldv_computer.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5bebdbb886722eb44013e5d4f265d40631e1b99dbc0d147d24501da17b1fa261
+size 4892828

examples/xpldv_house.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:aa47373d991677a2396edf79e6136011791706def7188430ae31671267bf0f65
+size 7261398

examples/xpldv_jet.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ec4c59f33f05fdbfa607318559f146da3f8a6150c40e54783438fa8e9e9fa389
+size 2537746

examples/xpldv_laptop.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bd9ad76dac9506e4822c8647e76a67a27c011b52b857ab7323fcd75230e61874
+size 3103810

examples/xpldv_suv.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:99a903374051689f4f1405163d37eb2e07f3234e795e715a33324cb769037b10
+size 5702745

examples/xpldv_watch.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b6f47b90a3b0c2571c9b38bb32147cd1b1aeb0ee301c52278c90161271935a5e
+size 4690792

ltx-2.5-xpldv_v5-lora.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:37b9609b1fb25a6c39542e195779648218829d03bed0d1fa8a612ed6a3b140bf
+size 402758608

prompt_guide.md

@@ -0,0 +1,88 @@
+# Prompting XPLDV
+
+Start with **“separates into an ordered exploded view.”** Name what moves, what becomes visible, and where the parts finish. Use direct words such as **moves up**, **moves outward**, and **remains suspended**.
+
+Use the [BASIC and COMPLEX templates](README.md#prompting) to start. BASIC suits a short reveal; COMPLEX adds specific internal parts and their locations. The [featured videos](README.md#featured-videos) contain complete prompts, and the [recommended settings](README.md#recommended-settings) are in the README.
+
+## Build the reveal
+
+1. **Choose the subject.** Describe the main object in the image. If several objects are visible, identify yours by its position or appearance.
+2. **Name what separates.** Each exterior part selected for separation must come completely free, move away, and remain suspended with a visible gap from the subject. Name parts individually when they should detach independently.
+3. **Name what becomes visible.** Be specific about the important interior parts and where they belong: “the V6 engine block ahead of the cabin” or “the battery beneath the palm rest.” Add recognizable features only when they help describe the reveal.
+4. **Describe the finish.** State that the detached parts remain suspended with visible gaps and keep their original shapes. Name the structure or interior parts that stay connected to the subject.
+
+Match the final arrangement to the movement:
+
+| Movement | Example wording |
+| --- | --- |
+| Vertical stack | “The screen, frame, and circuit board move vertically apart and remain suspended in aligned layers with visible gaps.” |
+| Horizontal row | “The components move horizontally apart and remain suspended in an ordered row.” |
+| Radial | “The panels move outward from the frame in a radial arrangement and remain suspended with visible gaps.” |
+
+Use “layered” for a stack. Different parts can move in different directions: a hood moves upward while doors move sideways. Add orientation details when they matter, such as keeping a glass cover flat.
+
+Describe one consistent timing pattern. If parts start together, say they move apart simultaneously. If they separate in stages, describe that order. Do not combine “first, then” with a requirement that every part start together.
+
+Describe internal movement separately from the exterior separation. Name which internal assemblies also move and which components remain mounted together. For example, a watch's mechanism can stay intact while its glass, hands, and dial separate. Listing every tiny gear is rarely necessary.
+
+## Keep the shot consistent
+
+Match the source image's motion and setting. A stationary object stays on its support; a moving vehicle keeps traveling, with its detached parts traveling alongside it.
+
+Choose one camera movement. Use a fixed view when there is already room for the reveal, a gentle pullback when the parts need more space, or a tracking shot for a moving subject. Request an orbit only when you want one. Keep the source lighting consistent.
+
+Audio is optional. Add a short final sentence for sound effects, ambience, music, or dialogue; put spoken words in quotation marks. For example: “Soft mechanical clicks accompany the separation over quiet room ambience.” Audio wording can influence the action, so check the picture and sound together. See [LTX's prompting guide](https://ltx.io/blog/ltx-2-5-prompt-guide) for more audio examples.
+
+## When the result needs work
+
+| Problem | What to change |
+| --- | --- |
+| Covers or doors open but stay attached | Specify complete detachment and a visible gap from the subject. |
+| A whole shell lifts off | Name the exterior parts individually and remove wording that keeps them connected. |
+| Parts overlap or barely separate | Specify each part's direction and the gap it should leave. |
+| The interior looks generic | Name the missing component, its location, and a few recognizable features. |
+| Parts duplicate, bend, or disappear | Simplify the parts list and check for conflicting movement instructions. |
+| Parts leave the frame | Give the camera room with a gentle pullback. |
+
+Change one thing at a time. Keep the image, seed, and settings fixed when testing a prompt revision. Watch the whole clip: a good final frame can hide problems during separation. Detailed-looking internals may still be inaccurate.
+
+<details>
+<summary>Qwen prompt builder — copy with your image</summary>
+
+With an Ollama node, supply the builder below as the instruction template and enter your shot request in **Guidance**. Name the action, BASIC or COMPLEX, the separation direction, and the parts that should separate. For motion throughout the clip, say so explicitly in Guidance and check that Qwen includes it in the generated prompt.
+
+Example Guidance:
+
+> SUV speeding and in motion the whole clip, complex, vertical exploding view - hood, wheels, doors, roof, outer shell
+
+Review both motion and separation in the finished clip. If your assistant has no separate Guidance field, add the shot request after the builder.
+
+```text
+Write one LTX 2.5 image-to-video prompt for the XPLDV exploded-view LoRA.
+
+Inspect the supplied image. Identify the target subject, its current motion or support, the exterior components that should detach, the desired internal reveal, the structure that stays assembled, appropriate movement paths, camera framing and lighting continuity. Follow the shot request supplied in Guidance, including its action, mode, and named parts.
+
+Before writing the final prompt, privately plan five major assemblies or reveal stages based on the subject's construction. Distinguish parts that detach, internal components that become visible, and structures that stay connected. Focus on large, visually meaningful assemblies and group related internal components when they belong together. This hierarchy guides the reveal; it does not require five detached pieces or a fixed animation sequence. Do not output the plan.
+
+Use BASIC for quick readable separation with a short list of named internal components. Use COMPLEX when specific internal identities, locations or connections are important. Honor the requested mode; if none is specified, start with BASIC.
+
+BASIC TEMPLATE:
+[SUBJECT] separates into an ordered exploded view. [NAMED OUTER PARTS] move outward along controlled paths, revealing [NAMED INTERNAL COMPONENTS] underneath. The parts settle into an organized [LAYERED / RADIAL] arrangement around [EXPOSED CORE] while retaining their original shapes. [CAMERA BEHAVIOR]. [LIGHTING CONSISTENT WITH THE IMAGE] remains consistent throughout the continuous shot.
+
+COMPLEX TEMPLATE:
+[SUBJECT] separates into an ordered exploded view while [CONTINUING ACTION OR ANCHORED SUPPORT]. [OUTER PART A] detaches and translates [DIRECTION], keeping [ORIENTATION]. [OUTER PART B] moves [DISTINCT PATH], and [OTHER OUTER PARTS] move [PATHS]. These exterior parts move first and travel furthest, leaving clear gaps. They reveal [SPECIFIC COMPONENT AND RECOGNIZABLE FEATURES] at [POSITION RELATIVE TO THE OBJECT], with [OTHER COMPONENTS AND THEIR LOCATIONS]. [CORE COMPONENTS] remain mounted together. Each detached section retains its shape as the arrangement settles and holds steady. [CAMERA BEHAVIOR]. [CONSISTENT LIGHTING] continues through one continuous shot.
+
+Adapt the chosen template to the actual image. Replace every placeholder with concrete wording. Keep BASIC concise. In COMPLEX, give important moving parts distinct paths and name what stays connected. Add small parts only when they matter to the requested reveal. Do not require the same component to stay attached and detach independently. When full separation is requested, describe the part coming free of its attachments and remaining suspended with a visible gap; opening on a hinge is not full separation.
+
+Preserve continuing motion when requested or clearly part of the intended shot, with the separated components traveling with the subject. Keep that action throughout the shot, including the final arrangement. Holding the arrangement steady means keeping the gaps steady relative to the moving subject. Keep stationary subjects on their support. Choose one camera behavior with enough room for the expanded arrangement and retain the source lighting.
+
+Describe clear spatial and assembly relationships. Use the selected template to describe the final arrangement. Match the arrangement to the paths: a vertical stack, horizontal row, or radial arrangement around the core. Adapt the exterior-first timing when a different sequence is requested. Keep every major part requested in Guidance; do not substitute smaller decorative details for it.
+
+When audio is requested, append a concise final sentence describing the desired sound effects, ambience, music or dialogue. Quote spoken dialogue. Match the audio to the intended visual action, recognizing that audio wording may influence that action. When audio is not requested, omit this optional sentence.
+
+Do not add destruction, reassembly, an orbit, a negative-prompt list or unrequested scene changes by default. Do not invent a required trigger token. Do not promise perfect part counts, background isolation or accurate hidden construction.
+
+Return only the completed positive prompt as one continuous paragraph, without headings, alternatives, placeholders or explanations.
+```
+
+</details>

training_config.yaml

@@ -0,0 +1,142 @@
+# Recorded training settings; machine-specific paths replaced with portable examples.
+# Validation prompts are preserved verbatim as training provenance.
+# These are training settings, not the recommended distilled inference defaults.
+acceleration:
+  load_text_encoder_in_8bit: false
+  mixed_precision_mode: bf16
+  offload_optimizer_during_validation: true
+  quantization: null
+checkpoints:
+  interval: 250
+  keep_last_n: -1
+  no_resume: false
+  precision: bfloat16
+  save_training_state: minimal
+data:
+  num_dataloader_workers: 0
+  preprocessed_data_root: dataset/.precomputed
+flow_matching:
+  timestep_sampling_mode: shifted_logit_normal
+  timestep_sampling_params: {}
+hub:
+  hub_model_id: null
+  push_to_hub: false
+lora:
+  alpha: 64
+  dropout: 0.0
+  rank: 64
+  target_modules:
+  - attn1.to_k
+  - attn1.to_q
+  - attn1.to_v
+  - attn1.to_out.0
+  - attn2.to_k
+  - attn2.to_q
+  - attn2.to_v
+  - attn2.to_out.0
+model:
+  audio_vae_path: models/vae/ltx-2.5-audio-vae-bf16.safetensors
+  load_checkpoint: null
+  model_path: models/diffusion_models/ltx-2.5-22b-dev-transformer-bf16.safetensors
+  text_encoder_path: models/text_encoders/gemma4-12b-with-proj-ltx-2.5-bf16.safetensors
+  training_mode: lora
+  video_vae_path: models/vae/ltx-2.5-video-vae-bf16.safetensors
+optimization:
+  batch_size: 1
+  enable_gradient_checkpointing: true
+  gradient_accumulation_steps: 4
+  learning_rate: 0.0001
+  max_grad_norm: 1.0
+  optimizer_type: adamw
+  scheduler_params: {}
+  scheduler_type: constant
+  steps: 4000
+output_dir: outputs/xpldv_lora_v5
+seed: 42
+training_strategy:
+  audio: null
+  name: flexible
+  video:
+    conditions:
+    - probability: 0.75
+      type: first_frame
+    is_generated: true
+    latents_dir: latents
+validation:
+  audio_cfg_scale: 4.0
+  audio_modality_guidance_scale: 3.0
+  audio_stg_scale: 1.0
+  frame_rate: 24.0
+  generate_audio: false
+  generate_video: true
+  guidance_rescale: 0.7
+  images: null
+  include_reference_in_output: false
+  inference_steps: 30
+  interval: 500
+  negative_prompt: worst quality, inconsistent motion, blurry, jittery, distorted
+  prompts: []
+  reference_downscale_factor: 1
+  reference_videos: null
+  samples:
+  - conditions:
+    - image_or_video: validation_images/xpld_house.png
+      type: first_frame
+    prompt: A two-storey craftsman house separates into an ordered exploded view.
+      The roof sections and the chimney move outward first and travel furthest, followed
+      by the gables and the exterior walls, then the porch columns, the garage doors
+      and the floor decks, all moving outward along controlled paths together. The
+      parts come to rest suspended in an organised arrangement. The camera is locked
+      off, facing the house head-on. Warm exterior lighting at dusk.
+    seed: null
+    video_dims: null
+  - conditions:
+    - image_or_video: validation_images/xpld_watch.png
+      type: first_frame
+    prompt: A stainless steel automatic wristwatch separates into an ordered exploded
+      view. The bracelet links and the case move outward first and travel furthest,
+      followed by the bezel and the dial, then the hands and the movement gears, all
+      moving outward along controlled paths together. The parts come to rest suspended
+      in an organised radial arrangement. The camera is locked off in a three-quarter
+      view. A harder key light from one side, with deep fill shadow.
+    seed: null
+    video_dims: null
+  - conditions:
+    - image_or_video: validation_images/xpld_suv_2.png
+      type: first_frame
+    prompt: A black SUV separates into an ordered exploded view. The doors and the
+      body panels move outward first and travel furthest, followed by the hood, the
+      wheels and the glass, then the engine and the chassis, all moving outward along
+      controlled radial paths together. The parts come to rest suspended in an organised
+      radial arrangement. The camera arcs slowly to the right around the SUV. Night
+      lighting from overhead street lamps.
+    seed: null
+    video_dims: null
+  - conditions:
+    - image_or_video: validation_images/xpld_laptop.png
+      type: first_frame
+    prompt: A silver laptop separates into an ordered exploded view. The display panel
+      and the lower case move outward first and travel furthest, followed by the keyboard
+      and the trackpad, then the battery, the logic board and the cooling fans, all
+      moving apart horizontally along controlled paths together. The parts come to
+      rest suspended in an ordered line. The camera arcs slowly to the left around
+      the laptop. Soft, even daylight from a window.
+    seed: null
+    video_dims: null
+  seed: 42
+  skip_initial_validation: true
+  stg_blocks:
+  - 28
+  video_cfg_scale: 4.0
+  video_dims: !!python/tuple
+  - 960
+  - 544
+  - 121
+  video_modality_guidance_scale: 3.0
+  video_stg_scale: 1.0
+wandb:
+  enabled: false
+  entity: null
+  log_validation_videos: true
+  project: ltxv-trainer
+  tags: []