Initial commit

.gitattributes

@@ -32,3 +32,5 @@ 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
+*.gif filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,162 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+.vscode/

LICENSE

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    flisol-cba-martin-fierro Copyright (C) 2023 Cristian Cardellino
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

README.md

@@ -1,3 +1,94 @@
 ---
+language:
+- es
 license: gpl-3.0
+tags:
+- generated_from_trainer
+model-index:
+- name: flisol-cba-martin-fierro
+  results: []
+widget:
+- text: "Aqui me pongo a cantar"
+  example_title: "Martin Fierro"
 ---
+
+Hugging Face: IA Colaborativa
+=============================
+
+En este repositorio estará disponible el código y modelo que entrené para la
+charla ["Hugging Face: IA Colaborativa"](https://eventol.flisol.org.ar/events/cordoba2023/activity/378/)
+del [FLISoL de Córdoba](https://cordoba.flisol.org.ar), Argentina, de 2023.
+
+Para inicializar el setup hace falta tener instalado y activado
+[`git-lfs`](https://git-lfs.com/).
+
+Pueden clonar el repositorio con:
+
+    $ git clone https://huggingface.co/crscardellino/flisol-cba-martin-fierro
+
+Y luego crean el entorno e instalan los requerimientos.
+
+    $ python -m venv flisol-venv
+    $ source ./flisol-venv/bin/activate
+    (flisol-venv) $ pip install -r requirements.txt
+
+El código está probado con Python 3.10, pero debería funcionar con Python >=
+3.8. En los requerimientos está organizado para instalar
+[PyTorch](https://pytorch.org/) v2.0.0 para cpu, pero pueden ajustarlo para
+utilizar GPUs suponiendo que cumplan los requerimientos de CUDA.
+
+## Model Specifications (Auto Generated)
+
+This model is a fine-tuned version of
+[DeepESP/gpt2-spanish](https://huggingface.co/DeepESP/gpt2-spanish) on the
+`./data/martin-fierro_train.txt` dataset.  It achieves the following results on
+the evaluation set:
+
+- Loss: 3.9067
+
+## Model description
+
+GPT-2 model finetuned on the poem ["El Gaucho Martin
+Fierro"](https://es.wikipedia.org/wiki/El_Gaucho_Mart%C3%ADn_Fierro)
+
+## Intended uses & limitations
+
+This was trained for the talk ["Hugging Face: IA
+Colaborativa"](https://eventol.flisol.org.ar/events/cordoba2023/activity/378/) @
+[FLISoL de Córdoba](https://cordoba.flisol.org.ar), Argentina, 2023.
+
+## Training and evaluation data
+
+### Training hyperparameters
+
+The following hyperparameters were used during training:
+- learning_rate: 2e-05
+- train_batch_size: 8
+- eval_batch_size: 8
+- seed: 42
+- optimizer: Adam with betas=(0.9,0.999) and epsilon=1e-08
+- lr_scheduler_type: linear
+- num_epochs: 10
+
+### Training results
+
+| Training Loss | Epoch | Step | Validation Loss |
+|:-------------:|:-----:|:----:|:---------------:|
+| 4.3864        | 1.0   | 18   | 4.2025          |
+| 3.948         | 2.0   | 36   | 4.0440          |
+| 3.7962        | 3.0   | 54   | 3.9804          |
+| 3.6105        | 4.0   | 72   | 3.9458          |
+| 3.4444        | 5.0   | 90   | 3.9280          |
+| 3.3855        | 6.0   | 108  | 3.9192          |
+| 3.3142        | 7.0   | 126  | 3.9091          |
+| 3.2192        | 8.0   | 144  | 3.9074          |
+| 3.1615        | 9.0   | 162  | 3.9070          |
+| 3.1637        | 10.0  | 180  | 3.9067          |
+
+
+### Framework versions
+
+- Transformers 4.28.1
+- Pytorch 2.0.0+cpu
+- Datasets 2.11.0
+- Tokenizers 0.13.3

chatbot.py

@@ -0,0 +1,202 @@
+"""
+Chatbot based on the notebook [How to generate text: using different decoding
+methods for language generation with
+Transformers](https://github.com/huggingface/blog/blob/main/notebooks/02_how_to_generate.ipynb)
+and the blog post [Create conversational agents using BLOOM:
+Part-1](https://medium.com/@fractal.ai/create-conversational-agents-using-bloom-part-1-63a66e6321c0).
+
+This code needs testing, as it is not fitted for a production model.
+
+It's a very basic chatbot that uses Causal Language Models from Transformers
+given an PROMPT.
+
+An example of a basic PROMPT is given in the file `prompt.txt` for a Spanish
+prompt.
+"""
+
+import argparse
+import torch
+
+from transformers import AutoModelForCausalLM, AutoTokenizer, PreTrainedModel,\
+    PreTrainedTokenizerBase
+from typing import Optional, Union
+
+
+class ChatBot:
+    """
+    Main class wrapper around the transformers models in order to build a basic
+    chatbot application.
+
+    Parameters
+    ----------
+    base_model : str | PreTrainedModel
+        A name (path in hugging face hub) for a model, or the model itself.
+    tokenizer : PreTrainedTokenizerBase | None
+        Needed in case the base_model is a given model, otherwise it will load
+        the same model given by the base_model path.
+    initial_prompt : str
+        A prompt for the model. Should follow the example given in
+        `BASE_PROMPT`
+    keep_context : bool
+        Whether to accumulate the context as the chatbot is used.
+    creative : bool
+        Whether to generate text through sampling (with some very basic config)
+        or to go with greedy algorithm. Check the notebook "How to generate
+        text" (link above) for more information.
+    max_tokens : int
+        Max number of tokens to generate in the chat.
+    human_identifier : str
+        The string that will identify the human speaker in the prompt (e.g.
+        HUMAN).
+    bot_identifier : str
+        The string that will identify the bot speaker in the prompt (e.g.
+        EXPERT).
+    """
+
+    def __init__(self,
+                 base_model: Union[str, PreTrainedModel],
+                 tokenizer: Optional[PreTrainedTokenizerBase] = None,
+                 initial_prompt: Optional[str] = None,
+                 keep_context: bool = False,
+                 creative: bool = False,
+                 max_tokens: int = 50,
+                 human_identifier: str = 'HUMAN',
+                 bot_identifier: str = 'EXPERT'):
+        if isinstance(base_model, str):
+            self.model = AutoModelForCausalLM.from_pretrained(
+                base_model,
+                low_cpu_mem_usage=True,
+                torch_dtype='auto'
+            )
+            self.tokenizer = AutoTokenizer.from_pretrained(base_model)
+        else:
+            assert isinstance(tokenizer, PreTrainedTokenizerBase),\
+                "If the base model is given, the tokenizer should be given as well"
+            self.model = base_model
+            self.tokenizer = tokenizer
+
+        if initial_prompt is None:
+            with open('./prompt.txt', 'r') as fh:
+                self.initial_prompt = fh.read()
+        else:
+            self.initial_prompt = initial_prompt
+
+        self.keep_context = keep_context
+        self.context = ''
+        self.creative = creative
+        self.max_tokens = max_tokens
+        self.human_identifier = human_identifier
+        self.bot_identifier = bot_identifier
+
+    def chat(self, input_text: str) -> str:
+        """
+        Generates a response from the prompt (and optionally the context) where
+        it adds the `input_text` as if it was part of the HUMAN dialog
+        (identified by `self.human_identifier`), and prompts the bot
+        (identified by `self.bot_identifier`) for a response. As the bot might
+        continue the conversation beyond the scope, it trims the output so it
+        only shows the first dialog given by the bot, following the idea
+        presented in the Medium blog post for creating conversational agents
+        (link above).
+
+        Parameters
+        ----------
+        input_text : str
+            The question asked/phrase prompted by a human.
+
+        Returns
+        -------
+        str
+            The output given by the bot, trimmed for better control.
+        """
+        # Setup the prompt given the initial prompt and add the words that
+        # start the dialog between the human and the bot. Give space for the
+        # model to continue from the prompt
+        prompt = self.initial_prompt + self.context
+        prompt += f'{self.human_identifier}: {input_text}\n'
+        prompt += f'{self.bot_identifier}: '  # check the space after the colon
+
+        input_ids = self.tokenizer.encode(prompt, return_tensors='pt')
+        if self.creative:
+            # In case you want the bot to be creative, we sample using `top_k`
+            # and `top_p`
+            output = self.model.generate(
+                input_ids,
+                do_sample=True,
+                max_length=input_ids.shape[1] + self.max_tokens,
+                top_k=50,
+                top_p=0.95
+            )[0]
+        else:
+            # Otherwise we return the most probable token
+            output = self.model.generate(
+                input_ids,
+                max_length=input_ids.shape[1] + self.max_tokens
+            )[0]
+
+        # Decode the output, removing special tokens for the model (like
+        # `[CLS]` and similar)
+        decoded_output = self.tokenizer.decode(output, skip_special_tokens=True)
+
+        # Trim the output, first by removing the original prompt
+        trimmed_output = decoded_output[len(prompt):]
+
+        # Then we find the stop token, in this case the human identifier, and
+        # we get up to that point
+        trimmed_output = trimmed_output[:trimmed_output.find(f'{self.human_identifier}:')]
+
+        if self.keep_context:
+            # If we want to keep the context of the conversation we add the
+            # trimmed output so far
+            self.context += prompt + trimmed_output
+
+        return trimmed_output.strip()  # we only return the trimmed output
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--model-name', '-m',
+                        default='bigscience/bloom-560m',
+                        help="Name of the base model to use for the chatbot")
+    parser.add_argument('--prompt', '-p',
+                        default='./prompt.txt',
+                        help="Path to the file with the prompt to use")
+    parser.add_argument('--keep-context', '-k',
+                        action='store_true',
+                        help="Keep context of the conversation.")
+    parser.add_argument('--creative', '-c',
+                        action='store_true',
+                        help="Make the bot creative when answering.")
+    parser.add_argument('--random-seed', '-r',
+                        default=42,
+                        help="Seed number for the creative bot.",
+                        type=int)
+    parser.add_argument('--human-identifier', '-i',
+                        default='HUMANO',
+                        help="Name of the human identifier.")
+    parser.add_argument('--bot-identifier', '-b',
+                        default='EXPERTO',
+                        help="Name of the bot identifier.")
+
+    args = parser.parse_args()
+
+    torch.manual_seed(args.random_seed)
+
+    with open(args.prompt, 'r') as fh:
+        initial_prompt = fh.read()
+
+    chatbot = ChatBot(
+        base_model=args.model_name,
+        initial_prompt=initial_prompt,
+        keep_context=args.keep_context,
+        creative=args.creative,
+        human_identifier=args.human_identifier,
+        bot_identifier=args.bot_identifier
+    )
+
+    print("Write `exit` or `quit` to quit")
+    while True:
+        input_text = input('> ')
+        if input_text == 'exit' or input_text == 'quit':
+            break
+        print(chatbot.chat(input_text))

config.json

@@ -0,0 +1,40 @@
+{
+  "_name_or_path": "DeepESP/gpt2-spanish",
+  "activation_function": "gelu_new",
+  "architectures": [
+    "GPT2LMHeadModel"
+  ],
+  "attn_pdrop": 0.1,
+  "bos_token_id": 50256,
+  "embd_pdrop": 0.1,
+  "eos_token_id": 50256,
+  "gradient_checkpointing": false,
+  "initializer_range": 0.02,
+  "layer_norm_epsilon": 1e-05,
+  "model_type": "gpt2",
+  "n_ctx": 1024,
+  "n_embd": 768,
+  "n_head": 12,
+  "n_inner": null,
+  "n_layer": 12,
+  "n_positions": 1024,
+  "reorder_and_upcast_attn": false,
+  "resid_pdrop": 0.1,
+  "scale_attn_by_inverse_layer_idx": false,
+  "scale_attn_weights": true,
+  "summary_activation": null,
+  "summary_first_dropout": 0.1,
+  "summary_proj_to_labels": true,
+  "summary_type": "cls_index",
+  "summary_use_proj": true,
+  "task_specific_params": {
+    "text-generation": {
+      "do_sample": true,
+      "max_length": 50
+    }
+  },
+  "torch_dtype": "float32",
+  "transformers_version": "4.28.1",
+  "use_cache": true,
+  "vocab_size": 50257
+}

data/martin-fierro_train.txt

@@ -0,0 +1,2907 @@
+I - Cantor y Gaucho.
+
+1
+Aquí me pongo a cantar
+Al compás de la vigüela,
+Que el hombre que lo desvela
+Una pena estraordinaria
+Como la ave solitaria
+Con el cantar se consuela.
+
+2
+Pido a los Santos del Cielo
+Que ayuden mi pensamiento;
+Les pido en este momento
+Que voy a cantar mi historia
+Me refresquen la memoria
+Y aclaren mi entendimiento.
+
+3
+Vengan Santos milagrosos,
+Vengan todos en mi ayuda,
+Que la lengua se me añuda
+Y se me turba la vista;
+Pido a Dios que me asista
+En una ocasión tan ruda.
+
+4
+Yo he visto muchos cantores,
+Con famas bien obtenidas,
+Y que después de adquiridas
+No las quieren sustentar
+Parece que sin largar
+se cansaron en partidas
+
+5
+Mas ande otro criollo pasa
+Martín Fierro ha de pasar;
+nada lo hace recular
+ni los fantasmas lo espantan,
+y dende que todos cantan
+yo también quiero cantar.
+
+6
+Cantando me he de morir
+Cantando me han de enterrar,
+Y cantando he de llegar
+Al pie del eterno padre:
+Dende el vientre de mi madre
+Vine a este mundo a cantar.
+
+7
+Que no se trabe mi lengua
+Ni me falte la palabra:
+El cantar mi gloria labra
+Y poniéndome a cantar,
+Cantando me han de encontrar
+Aunque la tierra se abra.
+
+8
+Me siento en el plan de un bajo
+A cantar un argumento:
+Como si soplara el viento
+Hago tiritar los pastos;
+Con oros, copas y bastos
+Juega allí mi pensamiento.
+
+9
+Yo no soy cantor letrao,
+Mas si me pongo a cantar
+No tengo cuándo acabar
+Y me envejezco cantando:
+Las coplas me van brotando
+Como agua de manantial.
+
+10
+Con la guitarra en la mano
+Ni las moscas se me arriman,
+Naides me pone el pie encima,
+Y cuando el pecho se entona,
+Hago gemir a la prima
+Y llorar a la bordona.
+
+11
+Yo soy toro en mi rodeo
+Y torazo en rodeo ajeno;
+Siempre me tuve por güeno
+Y si me quieren probar,
+Salgan otros a cantar
+Y veremos quién es menos.
+
+12
+No me hago al lao de la güeya
+Aunque vengan degollando,
+Con los blandos yo soy blando
+Y soy duro con los duros,
+Y ninguno en un apuro
+Me ha visto andar tutubiando.
+
+13
+En el peligro, ¡qué Cristos!
+El corazón se me enancha,
+Pues toda la tierra es cancha,
+Y de eso naides se asombre:
+El que se tiene por hombre
+Ande quiere hace pata ancha.
+
+14
+Soy gaucho, y entiendaló
+Como mi lengua lo esplica:
+Para mí la tierra es chica
+Y pudiera ser mayor;
+Ni la víbora me pica
+Ni quema mi frente el sol
+
+15
+Nací como nace el peje
+En el fondo de la mar;
+Naides me puede quitar
+Aquello que Dios me dio
+Lo que al mundo truje yo
+Del mundo lo he de llevar.
+
+16
+Mi gloria es vivir tan libre
+Como el pájaro del cielo:
+No hago nido en este suelo
+Ande hay tanto que sufrir,
+Y naides me ha de seguir
+Cuando yo remuento el vuelo.
+
+17
+Yo no tengo en el amor
+Quien me venga con querellas;
+Como esas aves tan bellas
+Que saltan de rama en rama,
+Yo hago en el trébol mi cama,
+Y me cubren las estrellas.
+
+18
+Y sepan cuantos escuchan
+De mis penas el relato,
+Que nunca peleo ni mato
+Sino por necesidá,
+Y que a tanta alversidá
+Sólo me arrojó el mal trato
+
+19
+Y atiendan la relación
+que hace un gaucho perseguido,
+que padre y marido ha sido
+empeñoso y diligente,
+y sin embargo la gente
+lo tiene por un bandido
+
+
+II - Ayer y hoy.
+
+20
+Ninguno me hable de penas,
+porque yo penado vivo,
+y naides se muestre altivo
+aunque en el estribo esté:
+que suele quedarse a pie
+el gaucho mas alvertido.
+
+21
+Junta esperencia en la vida
+hasta pa dar y prestar
+quien la tiene que pasar
+entre sufrimiento y llanto,
+porque nada enseña tanto
+como el sufrir y el llorar.
+
+22
+Viene el hombre ciego al mundo,
+cuartiándolo la esperanza,
+y a poco andar ya lo alcanzan
+las desgracias a empujones,
+¡la pucha, que trae liciones
+el tiempo con sus mudanzas!
+
+23
+Yo he conocido esta tierra
+en que el paisano vivía
+y su ranchito tenía
+y sus hijos y mujer...
+era una delicia el ver
+como pasaba sus días.
+
+24
+Entonces... cuando el lucero
+brillaba en el cielo santo,
+y los gallos con su canto
+nos decían que el día llegaba,
+a la cocina rumbiaba
+el gaucho... que un encanto.
+
+25
+Y sentao junto al jogón
+a esperar que venga el día,
+al cimarrón le prendía
+hasta ponerse rechoncho,
+mientras su china dormía
+tapadita con su poncho.
+
+26
+Y apenas la madrugada
+empezaba coloriar,
+los pájaros a cantar,
+y las gallinas a apiarse,
+era cosa de largarse
+cada cual a trabajar.
+
+27
+Este se ata las espuelas,
+se sale el otro cantando,
+uno busca un pellón blando,
+este un lazo, otro un rebenque,
+y los pingos relinchando
+los llaman dende el palenque.
+
+28
+El que era pion domador
+enderezaba al corral,
+ande estaba el animal
+bufidos que se las pela...
+y más malo que su agüela,
+se hacia astillas el bagual.
+
+29
+Y allí el gaucho inteligente,
+en cuanto el potro enriendó,
+los cueros le acomodó
+y se le sentó en seguida,
+que el hombre muestra en la vida
+la astucia que Dios le dio.
+
+30
+Y en las playas corcoviando
+pedazos se hacía el sotreta
+mientras él por las paletas
+le jugaba las lloronas,
+y al ruido de las caronas
+salía haciendo gambetas.
+
+31
+¡Ah, tiempos!... ¡Si era un orgullo
+ver jinetear un paisano!
+Cuando era gaucho baquiano,
+aunque el potro se boliase,
+no había uno que no parese
+con el cabresto en la mano.
+
+32
+Y mientras domaban unos,
+otros al campo salían
+y la hacienda recogían,
+las manadas repuntaban,
+y ansí sin sentir pasaban
+entretenidos el día.
+
+33
+Y verlos al cair la tarde
+en la cocina riunidos,
+con el juego bien prendido
+y mil cosas que contar,
+platicar muy divertidos
+hasta después de cenar.
+
+34
+Y con el buche bien lleno
+era cosa superior
+irse en brazos del amor
+a dormir como la gente,
+pa empezar el día siguiente
+las fainas del día anterior.
+
+35
+Ricuerdo ¡qué maravilla!
+Cómo andaba la gauchada
+siempre alegre y bien montada
+y dispuesta pa el trabajo...
+pero hoy en día... ¡barajo!
+No se la ve de aporriada.
+
+36
+El gaucho más infeliz
+tenía tropilla de un pelo,
+no le faltaba un consuelo
+y andaba la gente lista...
+teniendo al campo la vista,
+sólo vía hacienda y cielo.
+
+37
+Cuando llegaban las yerras,
+¡cosa que daba calor!
+Tanto gaucho pialador
+y tironiador sin yel.
+¡Ah, tiempos... pero si en él
+se ha visto tanto primor!
+
+38
+Aquello no era trabajo,
+mas bien era una junción,
+y después de un güen tirón
+en que uno se daba mana,
+pa darle un trago de cana
+solía llamarlo el patrón.
+
+39
+Pues vivía la mamajuana
+siempre bajo la carreta,
+y aquel que no era chancleta,
+en cuanto el goyete vía,
+sin miedo se le prendía
+como güérfano a la teta.
+
+40
+¡Y qué jugadas se armaban
+cuando estábamos riunidos!
+Siempre íbamos prevenidos,
+pues en tales ocasiones
+a ayudarle a los piones
+caiban muchos comedidos.
+
+41
+Eran los días del apuro
+y alboroto pa el hembraje,
+pa preparar los potajes
+y osequiar bien a la gente,
+y así, pues, muy grandemente,
+pasaba siempre el gauchaje.
+
+42
+Vení, a la carne con cuero,
+la sabrosa carbonada,
+mazamorra pien pisada,
+los pasteles y el güen vino...
+pero ha querido el destino
+que todo aquello acabara.
+
+43
+Estaba el gaucho en su pago
+con toda siguridá,
+pero aura... ¡barbaridá!,
+La cosa anda tan fruncida,
+que gasta el pobre la vida
+en juir de la autoridá.
+
+44
+Pues si usté pisa en su rancho
+y si el alcalde lo sabe,
+lo caza lo mesmo que ave
+aunque su mujer aborte...
+¡no hay tiempo que no se acabe
+ni tiento que no se corte!.
+
+45
+Y al punto dese por muerto
+si el alcalde lo bolea,
+pues ahí nomás se le apea
+con una felpa de palos;
+Y después dicen que es malo
+el gaucho si los pelea.
+
+46
+Y el lomo le hinchan a golpes,
+y le rompen la cabeza,
+y luego con ligereza,
+ansí lastimao y todo,
+lo amarran codo a codo
+y pa el cepo lo enderiezan.
+
+47
+Áhi comienzan sus desgracias,
+áhi principia el pericón,
+porque ya no hay salvación,
+y que usté quiera o no quiera,
+lo mandan a la frontera
+o lo echan a un batallón.
+
+48
+Ansí empezaron mis males
+lo mesmo que los de tantos;
+si gustan... en otros cantos
+les diré lo que he sufrido,
+después que uno está... perdido
+no lo salvan ni los santos.
+
+
+III - Sirviendo en la frontera.
+
+49
+tuve en mi pago en un tiempo
+hijos, hacienda y mujer,
+pero empecé a padecer,
+me echaron a la frontera,
+¡y qué iba a hallar al volver!
+Tan sólo hallé la tapera.
+
+50
+Sosegao vivía en mi rancho
+como el pájaro en su nido,
+allí mis hijos queridos
+iban creciendo a mi lao...
+sólo queda al desgraciao
+lamentar el bien perdido.
+
+51
+Mi gala en las pulperías
+era, en habiendo más gente,
+ponerme medio caliente,
+pues cuando puntiao me encuentro
+me salen coplas de adentro
+como agua de la virtiente.
+
+52
+Cantando estaba una vez
+en una gran diversión,
+y aprovecho la ocasión
+como quiso el juez de paz...
+se presentó, y ahi nomás
+hizo arriada en montón.
+
+53
+Juyeron los más matreros
+y lograron escapar:
+yo no quise disparar,
+soy manso y no había porqué,
+muy tranquilo me quedé
+y ansí me dejé agarrar
+
+54
+allí un gringo con un órgano
+y una mona que bailaba,
+haciéndonos rair estaba,
+cuanto le tocó el arreo,
+¡tan grande el gringo y tan feo,
+lo viera cómo lloraba!.
+
+55
+Hasta un inglés zanjiador
+que decía en la última guerra
+que él era de incalaperra
+y que no quería servir,
+también tuvo que juir
+a guarecerse en la sierra.
+
+56
+Ni los mirones salvaron
+de esa arriada de mi flor,
+fue acoyarao el cantor
+con el gringo de la mona,
+a uno solo, por favor,
+logró salvar la patrona.
+
+57
+Formaron un contingente
+con los que del baile arriaron,
+con otros nos mesturaron,
+que habían agarrao también,
+las cosas que aquí se ven
+ni los diablos las pensaron.
+
+58
+A mí el juez me tomó entre ojos
+en la ultima votación:
+me le había hecho el remolón
+y no me arrimé ese día,
+y él dijo que yo servía
+a los de la esposición.
+
+59
+Y ansí sufrí ese castigo
+tal vez por culpas ajenas,
+que sean malas o sean güenas
+las listas, siempre me escondo:
+yo soy un gaucho redondo
+y esas cosas no me enllenan.
+
+60
+Al mandarnos nos hicieron
+más promesas que a un altar,
+el juez nos jue a proclamar
+y nos dijo muchas veces:
+muchachos, a los seis meses
+los van a ir a relevar.
+
+61
+Yo llevé un moro de número
+¡sobresaliente el matucho!
+Con él gané en ayacucho
+más plata que agua bendita:
+siempre el gaucho necesita
+un pingo pa fiarle un pucho.
+
+62
+Y cargué sin dar mas güeltas
+con las prendas que tenía:
+jergas, ponchos, todo cuanto había
+en casa, tuito lo alcé:
+a mi china la dejé
+medio desnuda ese día.
+
+63
+No me falta una guasca,
+esa ocasión eché el resto,
+bozal, maniador, cabresto,
+lazo, bolas y manea...
+¡el que hoy tan pobre me vea
+tal vez no creerá todo esto!.
+
+64
+Ansí en mi moro, escarciando,
+enderecé a la frontera.
+¡Aparcero si usté viera
+lo que se llama cantón!...
+Ni envidia tengo al ratón
+en aquella ratonera.
+
+65
+De los pobres que allí había
+a ninguno lo largaron,
+los más viejos rezongaron,
+pero a uno que se quejó
+en seguida lo estaquiaron,
+y la cosa se acabó.
+
+66
+En la lista de la tarde
+el jefe nos cantó el punto
+diciendo: quinientos juntos
+llevará el que se resierte;
+lo haremos pitar del juerte,
+mas bien dese por dijunto.
+
+67
+A naides le dieron armas,
+pues toditas las que había
+el coronel las tenía,
+sigún dijo esa ocasión,
+pa repartirlas el día
+en que hubiera una invasión.
+
+68
+Al principio nos dejaron
+de haraganes criando sebo,
+pero después... no me atrevo
+a decir lo que pasaba...
+¡barajo!... Si nos trataban
+como se trata a malevos.
+
+69
+Porque todo era jugarle
+por los lomos con la espada,
+y aunque usté no hiciera nada,
+lo mesmito que en palermo,
+le daban cada cepiada
+que lo dejaban enfermo.
+
+70
+¡Y qué indios, ni qué servicio;
+si allí no había ni cuartel!
+Nos mandaba el coronel
+a trabajar en sus chacras,
+y dejábamos las vacas
+que las llevara el infiel.
+
+71
+Yo primero sembré trigo
+y después hice un corral,
+corté adobe pa un tapial,
+hice un quincho, corté paja...
+¡la pucha que se trabaja
+sin que le larguen un rial!.
+
+72
+Y es lo pior de aquel enriedo
+que si uno anda hinchando el lomo
+se le apean como un plomo...
+¡quién aguanta aquel infierno!
+si eso es servir al gobierno,
+a mí no me gusta el cómo.
+
+73
+Más de un año nos tuvieron
+en esos trabajos duros;
+y los indios, le asiguro
+dentraban cuando querían:
+como no los perseguían,
+siempre andaban sin apuro.
+
+74
+A veces decía al volver
+del campo la descubierta
+que estuviéramos alerta,
+que andaba adentro la indiada,
+porque había una rastrillada
+o estaba una yegua muerta.
+
+75
+Recién entonces salía
+la orden de hacer la riunión,
+y caíbamos al cantón
+en pelos y hasta enancaos,
+sin armas, cuatro pelaos
+que íbamos a hacer jabón.
+
+76
+Ahi empezaba el afán
+-se entiende, de puro vicio-
+de enseñarle el ejercicio
+a tanto gaucho recluta,
+con un estrutor... ¡qué... Bruta!
+que nunca sabía su oficio.
+
+77
+Daban entonces las armas
+pa defender los cantones,
+que eran lanzas y latones
+con ataduras de tiento...
+las de juego no las cuento
+porque no había municiones.
+
+78
+Y un sargento chamuscao
+me contó que las tenían
+pero que ellos la vendían
+para cazar avestruces;
+y así andaban noche y día
+dele bala a los ñanduces.
+
+79
+Y cuando se iban los indios
+con lo que habían manotiao,
+salíamos muy apuraos
+a perseguirlos de atrás;
+si no se llevaban más
+es porque no habían hallao.
+
+80
+Allí sí, se ven desgracias
+y lágrimas y afliciones;
+naides le pida perdones
+al indio: pues donde dentra,
+roba y mata cuanto encuentra
+y quema las poblaciones.
+
+81
+No salvan de su juror
+ni los pobres angelitos;
+viejos, mozos y chiquitos
+los mata del mesmo modo:
+que el indio lo arregla todo
+con la lanza y con gritos.
+
+82
+Tiemblan las carnes al verlo
+volando al viento la cerda,
+la rienda en la mano izquierda
+y la lanza en la derecha;
+ande enderieza abre brecha
+pues no hay lanzazo que pierda.
+
+83
+Hace trotiadas tremendas
+desde el fondo del desierto;
+ansí llega medio muerto
+de hambre, de sé y de fatiga;
+pero el indio es una hormiga
+que día y noche está despierto.
+
+84
+Sabe manejar las bolas
+como naides las maneja;
+cuanto el contrario se aleja,
+manda una bola perdida,
+y si lo alcanza, sin vida
+es siguro que lo deja.
+
+85
+Y el indio es como tortuga
+de duro para espichar;
+si lo llega a destripar
+ni siquiera se le encoge;
+luego sus tripas recoge,
+y se agacha a disparar.
+
+86
+Hacían el robo a su gusto
+y después se iban de arriba;
+se llevaban las cautivas,
+y nos contaban que a veces
+les descarnaban los pieses,
+a las pobrecitas, vivas.
+
+87
+¡Ah! ¡si partía el corazón
+ver tantos males, canejo!
+los perseguíamos de lejos
+sin poder ni galopiar;
+¡y qué habíamos de alcanzar
+en unos vichocos viejos!
+
+88
+Nos volvíamos al cantón
+a las dos o tres jornadas,
+sembrando las caballadas;
+y pa que alguno la venda,
+rejuntábamos la hacienda
+que habían dejao rezagada.
+
+89
+Una vez entre otras muchas,
+tanto salir al botón,
+nos pegaron un malón
+los indios y una lanciada,
+que la gente acobardada
+quedó dende esa ocasión.
+
+90
+Habían estao escondidos
+aguaitando atrás de un cerro...
+¡lo viera a su amigo Fierro
+aflojar como un blandito!
+salieron como maíz frito
+en cuanto sonó un cencerro.
+
+91
+Al punto nos dispusimos
+aunque ellos eran bastantes;
+la formamos al instante
+nuestra gente, que era poca,
+y golpiándose en la boca
+hicieron fila adelante.
+
+92
+Se vinieron en tropel
+haciendo temblar la tierra.
+no soy manco pa la guerra
+pero tuve mi jabón,
+pues iba en un redomón
+que había boleao en la sierra.
+
+93
+¡Qué vocerío! ¡qué barullo!
+¡qué apurar esa carrera!
+la indiada todita entera
+dando alaridos cargó,
+¡jue pucha!... Y ya nos sacó
+como yeguada matrera.
+
+94
+¡Qué fletes traiban los bárbaros!
+¡como una luz de ligeros!
+hicieron el entrevero
+y en aquella mezcolanza,
+este quiero, éste no quiero,
+nos escogían con la lanza.
+
+95
+Al que le daban un chuzazo,
+dificultoso es que sane.
+en fin, para no echar panes,
+salimos por esas lomas,
+lo mesmo que las palomas
+al juir de los gavilanes.
+
+96
+¡Es de almirar la destreza
+con que la lanza manejan!
+de perseguir nunca dejan,
+y nos traiban apretaos.
+¡si queríamos, de apuraos,
+salirnos por las orejas!
+
+97
+Y pa mejor de la fiesta
+en esa aflición tan suma,
+vino un indio echando espuma,
+y con la lanza en la mano,
+gritando: acabáu cristiano,
+metau el lanza hasta el pluma.
+
+98
+Tendido en el costillar,
+cimbrando por sobre el brazo
+una lanza como un lazo,
+me atropelló dando gritos:
+si me descuido... El maldito
+me levanta de un lanzazo.
+
+99
+Si me atribulo o me encojo,
+siguro que no me escapo:
+siempre he sido medio guapo,
+pero en aquella ocasión
+me hacía buya el corazón
+como la garganta al sapo.
+
+100
+Dios le perdone al salvaje
+las ganas que me tenía...
+desaté las tres marías
+y lo engatusé a cabriolas...
+¡pucha...! Si no traigo bolas
+me achura el indio ese día.
+
+101
+Era el hijo de un cacique,
+sigún yo lo averigüé;
+la verdá del caso jue
+que me tuvo apuradazo,
+hasta que por fin de un bolazo
+del caballo lo bajé.
+
+102
+Ahi no más me tiré al suelo
+y lo pisé en las paletas;
+empezó a hacer morisquetas
+y a mezquinar la garganta...
+pero yo hice la obra santa
+de hacerlo estirar la jeta.
+
+103
+Allí quedó de mojón
+y en su caballo salté;
+de la indiada disparé,
+pues si me alcanza me mata,
+y al fin me les escapé,
+con el hilo de una pata.
+
+
+IV - El pulpero. A buena cuenta.
+
+104
+seguiré esta relación,
+aunque pa chorizo es largo:
+el que pueda hágase cargo
+cómo andaría de matrero,
+después de salvar el cuero
+de aquel trance tan amargo.
+
+105
+Del sueldo nada les cuento,
+porque andaba disparando;
+nosotros de cuando en cuando
+solíamos ladrar de pobres:
+nunca llegaban los cobres
+que se estaban aguardando.
+
+106
+Y andábamos de mugrientos
+que el mirarnos daba horror;
+les juro que era un dolor
+ver esos hombres, ¡por cristo!
+En mi perra vida he visto
+una miseria mayor.
+
+107
+Yo no tenía ni camisa
+ni cosa que se parezca;
+mis trapos sólo pa yesca
+me podían servir al fin...
+no hay plaga como un fortín
+para que el hombre padezca.
+
+108
+Poncho, jergas, el apero,
+las prenditas, los botones,
+todo, amigo, en los cantones
+jue quedando poco a poco;
+ya me tenían medio loco
+la pobreza y los ratones.
+
+109
+Sólo una manta peluda
+era cuanto me quedaba
+la había agenciao a la tabla
+y ella me tapaba el bulto;
+yaguané que allí ganaba
+no salía- ni con indulto.
+
+110
+Y pa mejor hasta el moro
+se me jue de entre las manos;
+no soy lerdo pero, hermano,
+vino el comendante un día
+diciendo que lo quería
+pa enseñarle a comer grano.
+
+111
+Afigúrese cualquiera
+la suerte de este su amigo,
+a pie y mostrando el umbligo,
+estropiao, pobre y desnudo;
+ni por castigo se pudo
+hacerse más mal conmigo.
+
+112
+Ansí pasaron los meses,
+y vino el año siguiente,
+y las cosas igualmente
+siguieron del mesmo modo:
+adrede parece todo
+pa atormentar a la gente.
+
+113
+No teníamos más permiso,
+ni otro alivio la gauchada,
+que salir de madrugada,
+cuando no había indio ninguno,
+campo ajuera a hacer boliadas
+desocando los reyunos.
+
+114
+Y cáibamos al cantón
+con los fletes aplastaos,
+pero a veces medio aviaos
+con plumas y algunos cueros,
+que pronto con el pulpero
+los teníamos negociaos.
+
+115
+Era un amigo del jefe
+que con un boliche estaba;
+yerba y tabaco nos daba
+por la pluma de avestruz,
+y hasta le hacía ver la luz
+al que un cuero le llevaba.
+
+116
+Sólo tenía cuatro frascos
+y unas barricas vacías,
+y a la gente le vendía
+todo cuanto precisaba...
+algunos creiban que estaba
+allí la proveduría.
+
+117
+¡Ah, pulpero habilidoso!
+Nada le solía faltar.
+¡Ahijuna!, Para tragar
+tenía un buche de ñandú;
+la gente le dio en llamar
+el boliche de virtú.
+
+118
+Aunque es justo que quien vende
+algún poquito muerda,
+tiraba tanto la cuerda
+que, con sus cuatro limetas
+él cargaba las carretas
+de plumas, cueros y cerda.
+
+119
+Nos tenía apuntaos a todos
+con más cuentas que un rosario,
+cuando se anunció un salario
+que iban a dar, o un socorro;
+pero sabe Dios qué zorro
+se lo comió al comisario;
+
+120
+pues nunca lo vi llegar,
+y al cabo de muchos días
+en la mesma pulpería
+dieron una güena cuenta,
+que la gente muy contenta
+de tan pobre recibía.
+
+121
+Sacaron unos sus prendas,
+que las tenían empeñadas;
+por sus deudas atrasadas
+dieron otros el dinero;
+al fin de fiesta el pulpero
+se quedó con la mascada.
+
+122
+Yo me arrescosté a un horcón
+dando tiempo a que pagaran,
+y poniendo güena cara
+estuve haciéndome el poyo,
+a esperar que me llamaran
+para recibir mi boyo.
+
+123
+Pero ahi me puede quedar
+pegao pa siempre al horcón,
+ya era casi la oración
+y ninguno me llamaba;
+la cosa se me ñublaba
+y me dentró comezón.
+
+124
+Pa sacarme el entripao
+vi al mayor, y lo fi a hablar;
+yo me lo empecé a atracar,
+y como con poca gana
+le dije: tal vez mañana
+acabarán de pagar.
+
+125
+¡Que mañana ni otro día!,
+Al punto me contestó:
+la paga ya se acabó;
+¡siempre has de ser animal!
+Me raí y le dije: yo...
+no he recebido ni un rial.
+
+126
+Se le pusieron los ojos
+que se le querían salir,
+y ahi no más volvió a decir
+comiéndome con la vista:
+¿y qué querés recibir
+si no has dentrao en la lista?
+
+127
+Esto sí que es amolar,
+dije yo pa mis adentros;
+van dos años que me encuentro
+y hasta aura he visto ni un grullo;
+dentro en todos los barullos
+pero en las listas no dentro.
+
+128
+Vide el pleito mal parao
+y no quise aguardar más...
+es güeno vivir en paz
+con quien nos ha de mandar;
+y reculando pa atrás
+me le empecé a retirar.
+
+129
+Supo todo el comendante
+y me llamó al otro día,
+diciéndome que quería
+aviriguar bien las cosas...
+que no era el tiempo de rosas,
+que aura a naides se debía.
+
+130
+Llamó al cabo y al sargento
+y empezó la indagación:
+si había venido al cantón
+en tal tiempo o en tal otro...
+y si había venido en potro,
+en reyuno o redomón.
+
+131
+Y todo era alborotar
+al ñudo, y hacer papel;
+conocí que era pastel
+pa engordar con mi guayaca;
+mas si voy al coronel
+me hacen bramar en la estaca.
+
+132
+¡Ah, hijos de una...! ¡La codicia
+ojalá les ruempa el saco!
+Ni un pedazo de tabaco
+le dan al pobre soldao,
+y lo tienen, de delgao,
+más ligero que un guanaco.
+
+133
+Pero qué iba a hacerles yo,
+charabón en el desierto;
+más bien me daba por muerto
+pa no verme más fundido:
+y me les hacía el dormido
+aunque soy medio despierto.
+
+
+V - Gringos en la frontera. La estaquiada.
+
+134
+Yo andaba desesperao,
+aguardando una ocasión
+que los indios un malón
+nos dieran, y entre el estrago
+hacérmeles cimarrón
+y volverme pa mi pago.
+
+135
+Aquello no era servicio
+ni defender la frontera;
+aquello era ratonera
+en que sólo gana el juerte:
+era jugar a la suerte
+con una taba culera.
+
+136
+Allí tuito va al revés;
+los milicos son los piones,
+y andan en las poblaciones
+emprestaos pa trabajar;
+los rejuntan pa peliar
+cuando entran indios ladrones.
+
+137
+Yo he visto en esa milonga
+muchos jefes con estancia,
+y piones en abundancia,
+y majadas y rodeos;
+he visto negocios feos
+a pesar de mi inorancia.
+
+138
+Y colijo que no quieren
+la barunda componer;
+para eso no ha de tener,
+el jefe que esté de estable,
+más que su poncho y su sable,
+su caballo y su deber.
+
+139
+Ansina, pues, conociendo
+que aquel mal no tiene cura,
+que tal vez mi sepoltura
+si me quedo iba a encontrar,
+pensé mandarme mudar
+como cosa más sigura.
+
+140
+Y pa mejor, una noche
+¡qué estaquiada me pegaron!
+Casi me descoyuntaron
+por motivo de una gresca:
+¡ahijuna, si me estiraron
+lo mesmo que guasca fresca!
+
+141
+Jamás me puedo olvidar
+lo que esa vez me pasó;
+dentrando una noche yo
+al fortín, un enganchao,
+que estaba medio mamao,
+allí me desconoció.
+
+142
+Era un gringo tan bozal,
+que nada se le entendía,
+¡quién sabe de ande sería!
+Tal vez no juera cristiano,
+pues lo único que decía
+es que era papolitano.
+
+143
+Estaba de centinela
+y por causa del peludo
+verme más claro no pudo,
+y esa jue la culpa toda:
+el bruto se asustó al ñudo
+y fi el pavo de la boda.
+
+144
+Cuando me vido acercar:
+quién vivore-? Preguntó;
+¿qué víboras?, Dije yo.
+¡Ha garto!, Me pegó el grito,
+y yo dije despacito:
+¡más lagarto serás vos!
+
+145
+Ahi no más, ¡cristo me valga!,
+Rastrillar el jusil siento:
+me agaché, y en el momento
+el bruto me largó un chumbo;
+mamao, me tiró sin rumbo,
+que si no, no cuento el cuento.
+
+146
+Por de contao, con el tiro
+se alborotó el avispero;
+los oficiales salieron
+y se empezó la junción;
+quedó en su puesto el nación,
+y yo fi al estaquiadero.
+
+147
+Entre cuatro bayonetas
+me tendieron en el suelo;
+vino el mayor medio en pedo
+y allí se puso a gritar:
+¡pícaro, te he de enseñar
+andar reclamando sueldos!
+
+148
+De las manos y las patas
+me ataron cuatro cinchones;
+les aguanté los tirones
+sin que ni un ¡ay! Se me oyera,
+y al gringo la noche entera
+lo harté con mis maldiciones.
+
+149
+Yo no sé porqué el gobierno
+nos manda aquí a la frontera
+gringada que ni siquiera
+se sabe atracar a un pingo.
+¡Si creerá al mandar un gringo
+que nos manda alguna fiera!
+
+150
+No hacen más que dar trabajo,
+pues no saben ni ensillar;
+no sirven ni pa carniar:
+y yo he visto muchas veces
+que ni voltiadas las reses
+se les querían arrimar.
+
+151
+Y lo pasan sus mercedes
+lengüetiando pico a pico
+hasta que viene un milico
+a servirles al asao-
+y eso sí, en lo delicaos,
+parecen hijos de rico.
+
+152
+Si hay calor, ya no son gente;
+si yela, todos tiritan;
+si usté no les da, no pitan
+por no gastar en tabaco,
+y cuando pescan un naco
+uno al otro se lo quitan.
+
+153
+Cuando llueve se acoquinan
+como perro que oye truenos.
+¡Que diablos!, Sólo son güenos
+pa vivir entre maricas,
+y nunca se andan con chicas
+para alzar ponchos ajenos.
+
+154
+Pa vichar son como ciegos;
+no hay ejemplo de que entiendan,
+ni hay uno solo que aprienda,
+al ver un bulto que cruza,
+a saber si es avestruza,
+o si es jinete, o hacienda.
+
+155
+Si salen a perseguir
+después de mucho aparato,
+tuitos se pelan al rato
+y va quedando el tendal:
+esto es como en un nidal
+echarle güevos a un gato.
+
+
+VI - Desertor. Las ruinas del rancho.
+
+156
+vamos dentrando recién
+a la parte mas sentida,
+aunque es todita mi vida
+de males una cadena:
+a cada alma dolorida
+le gusta cantar sus penas.
+
+157
+Se empezó en aquel entonces
+a rejuntar caballada,
+y riunir la milicada
+teniéndola en el cantón,
+para una despedición
+a sorprender a la indiada.
+
+158
+Nos anunciaban que iríamos
+sin carretas ni bagajes
+a golpiar a los salvajes
+en sus mesmas tolderías;
+que a la güelta pagarían
+licenciándolo al gauchaje;
+
+159
+que en esta despedición
+tuviéramos la esperanza;
+que iba a venir sin tardanza,
+según el jefe contó,
+un menistro o qué sé yo-
+que le llamaban don ganza;
+
+160
+que iba a riunir el ejército
+y tuitos los batallones,
+y que traiba unos cañones
+con más rayas que un cotín;
+¡pucha!- Las conversaciones
+por allá no tenían fin.
+
+161
+Pero esas trampas no enriedan
+a los zorros de mi laya;
+que esa ganza venga o vaya,
+poco le importa a un matrero.
+Yo también dejé las rayas-
+en los libros del pulpero.
+
+162
+Nunca juí gaucho dormido;
+siempre pronto, siempre listo,
+yo soy un hombre, ¡qué cristo!,
+Que nada me ha acobardao,
+y siempre salí parao
+en los trances que me he visto.
+
+163
+Dende chiquito gané
+la vida con mi trabajo,
+y aunque siempre estuve abajo
+y no sé lo que es subir
+también el mucho sufrir
+suele cansarnos, ¡barajo!
+
+164
+En medio de mi inorancia
+conozco que nada valgo:
+soy la liebre o soy el galgo
+asigún los tiempos andan;
+pero también los que mandan
+debieran cuidarnos algo.
+
+165
+Una noche que riunidos
+estaban en la carpeta
+empinando una limeta
+el jefe y el juez de paz,
+yo no quise aguardar más,
+y me hice humo en un sotreta.
+
+166
+Me parece el campo orégano
+dende que libre me veo;
+donde me lleva el deseo
+allí mis pasos dirijo,
+y hasta en las sombras de fijo
+que donde quiera rumbeo.
+
+167
+Entro y salgo del peligro
+sin que me espante el estrago,
+no aflojo al primer amago
+ni jamás fi gaucho lerdo:
+soy pa rumbiar como el cerdo,
+y pronto caí a mi pago.
+
+168
+Volvía al cabo de tres años
+de tanto sufrir al ñudo
+resertor, pobre y desnudo,
+a procurar suerte nueva;
+y lo mesmo que el peludo
+enderecé pa mi cueva.
+
+169
+No hallé ni rastro del rancho:
+¡sólo estaba la tapera!
+¡Por cristo si aquello era
+pa enlutar el corazón!
+¡Yo juré en esa ocasión
+ser mas malo que una fiera!
+
+170
+¡Quién no sentirá lo mesmo
+cuando ansí padece tanto!
+Puedo asigurar que el llanto
+como una mujer largué:
+¡ay, mi Dios: si me quedé
+más triste que jueves santo!
+
+171
+Sólo se oíban los aullidos
+de un gato que se salvó;
+el pobre se guareció
+cerca, en una vizcachera:
+venía como si supiera
+que estaba de güelta yo.
+
+172
+Al dirme dejé la hacienda
+que era todito mi haber;
+pronto debíamos volver,
+sigún el juez prometía,
+y hasta entonces cuidaría
+de los bienes, la mujer.
+
+173
+Después me contó un vecino
+que el campo se lo pidieron;
+la hacienda se la vendieron
+pa pagar arrendamientos,
+y qué sé yo cuantos cuentos;
+pero todo lo fundieron,
+
+174
+los pobrecitos muchachos,
+entre tantas afliciones,
+se conchabaron de piones;
+¡mas qué iban a trabajar,
+si eran como los pichones
+sin acabar de emplumar!
+
+175
+Por ahi andarán sufriendo
+de nuestra suerte el rigor:
+me han contao que el mayor
+nunca dejaba a su hermano;
+puede ser que algún cristiano
+los recoja por favor.
+
+176
+¡Y la pobre mi mujer,
+Dios sabe cuánto sufrió!
+Me dicen que se voló
+con no sé qué gavilán:
+sin duda a buscar el pan
+que no podía darle yo.
+
+177
+No es raro que a uno le falte
+lo que a algún otro le sobre
+si no le quedó ni un cobre
+sino de hijos un enjambre.
+Que más iba a hacer la pobre
+para no morirse de hambre?
+
+178
+¡Tal vez no te vuelva a ver,
+prienda de mi corazón!
+Dios te dé su proteción
+ya que no me la dio a mí,
+y a mis hijos dende aquí
+les echo mi bendición.
+
+179
+Como hijitos de la cuna
+andarán por ahi sin madre;
+ya se quedaron sin padre,
+y ansí la suerte los deja
+sin naides que los proteja
+y sin perro que les ladre.
+
+180
+Los pobrecitos tal vez
+no tengan ande abrigarse,
+ni ramada ande ganarse,
+ni rincón ande meterse,
+ni camisa que ponerse,
+ni poncho con que taparse.
+
+181
+Tal vez los verán sufrir
+sin tenerles compasión;
+puede que alguna ocasión,
+aunque los vean tiritando,
+los echen de algún jogón
+pa que no estén estorbando.
+
+182
+Y al verse ansina espantaos
+como se espanta a los perros,
+irán los hijos de Fierro,
+con la cola entre las piernas,
+a buscar almas más tiernas
+o esconderse en algún cerro.
+
+183
+Mas también en este juego
+voy a pedir mi bolada;
+a naides le debo nada,
+ni pido cuartel ni doy:
+y ninguno dende hoy
+ha de llevarme en la armada.
+
+184
+Yo he sido manso primero,
+y seré gaucho matrero;
+en mi triste circunstancia,
+aunque es mi mal tan projundo,
+nací y me he criado en estancia.
+Pero ya conozco el mundo.
+
+185
+Ya les conozco sus mañas,
+le conozco sus cucañas;
+sé como hacen la partida,
+la enriedan y la manejan;
+deshaceré la madeja
+aunque me cueste la vida.
+
+186
+Y aguante el que no se anime
+a meterse en tanto engorro
+o si no aprétese el gorro
+y para otra tierra emigre;
+pero yo ando como el tigre
+que le roban los cachorros.
+
+187
+Aunque muchos creen que el gaucho
+tiene alma de reyuno,
+no se encontrará a ninguno
+que no le dueblen las penas;
+mas no debe aflojar uno
+mientras hay sangre en las venas
+
+
+VII - Pelea con el moreno.
+
+188
+De carta de más me vía
+sin saber a donde dirme;
+mas dijeron que era vago
+y entraron a perseguirme.
+
+189
+Nunca se achican los males,
+van poco a poco creciendo,
+y ansina me vide pronto
+obligado a andar juyendo.
+
+190
+No tenía mujer ni rancho
+y a más, era resertor;
+no tenía una prenda güena
+ni un peso en el tirador
+
+191
+a mis hijos infelices
+pensé volverlos a hallar,
+y andaba de un lao al otro
+sin tener ni qué pitar.
+
+192
+Supe una vez por desgracia
+que había un baile por allí,
+y medio desesperao
+a ver la milonga fui.
+
+193
+Riunidos al pericón
+tantos amigos hallé,
+que alegre de verme entre ellos
+esa noche me apedé.
+
+194
+Como nunca, en la ocasión
+por peliar me dio la tranca.
+Y la emprendí con un negro
+que trujo una negra en ancas.
+
+195
+Al ver llegar la morena,
+que no hacía caso de naides,
+le dije con la mamúa:
+va-ca-yendo gente al baile.
+
+196
+La negra entendió la cosa
+y no tardó en contestarme,
+mirándome como a un perro:
+más vaca será su madre.
+
+197
+Y dentró al baile muy tiesa
+con más cola que una zorra,
+haciendo blanquiar los dientes
+lo mesmo que mazamorra.
+
+198
+!Negra linda!- Dije yo.
+Me gusta- pa la carona;
+y me puse a champurriar
+esta coplita fregona:
+
+199
+a los blancos hizo Dios,
+a los mulatos san pedro,
+a los negros hizo el diablo
+para tizón del infierno.
+
+200
+Había estao juntando rabia
+el moreno dende ajuera;
+en lo escuro le brillaban
+los ojos como linterna.
+
+201
+Lo conocí retobao,
+me acerqué y le dije presto:
+po-r-rudo que un hombre sea
+nunca se enoja por esto.
+
+202
+Corcovió el de los tamangos
+y creyéndose muy fijo:
+¡más porrudo serás vos,
+gaucho rotoso!, Me dijo.
+
+203
+Y ya se me vino al humo
+como a buscarme la hebra,
+y un golpe le acomodé
+con el porrón de ginebra.
+
+204
+Ahi nomás pegó el de hollín
+mas gruñidos que un chanchito,
+y pelando el envenao
+me atropelló dando gritos.
+
+205
+Pegué un brinco y abrí cancha
+diciéndoles: caballeros,
+dejen venir ese toro.
+Solo nací- solo muero.
+
+206
+El negro, después del golpe,
+se había el poncho refalao
+y dijo: vas a saber
+si es solo o acompañado.
+
+207
+Y mientras se arremangó,
+yo me saqué las espuelas,
+pues malicié que aquel tío
+no era de arriar con las riendas.
+
+208
+No hay cosa como el peligro
+pa refrescar un mamao;
+hasta la vista se aclara
+por mucho que haiga chupao.
+
+209
+El negro me atropelló
+como a quererme comer;
+me hizo dos tiros seguidos
+y los dos le abarajé.
+
+210
+Yo tenía un facón con s,
+que era de lima de acero;
+le hice un tiro, lo quitó
+y vino ciego el moreno;
+
+211
+y en el medio de las aspas
+un planazo le asenté,
+que lo largué culebriando
+lo mesmo que buscapié.
+
+212
+Le coloriaron las motas
+con la sangre de la herida,
+y volvió a venir jurioso
+como una tigra parida.
+
+213
+Y ya me hizo relumbrar
+por los ojos el cuchillo,
+alcanzando con la punta
+a cortarme en un carrillo.
+
+214
+Me hirvió la sangre en las venas
+y me le afirmé al moreno,
+dándole de punta y hacha
+pa dejar un diablo menos.
+
+215
+Por fin en una topada
+en el cuchillo lo alcé,
+y como un saco de güesos
+contra un cerco lo largué.
+
+216
+Tiró unas cuantas patadas
+y ya cantó pal carnero:
+nunca me puedo olvidar
+de la agonía de aquel negro.
+
+217
+En esto la negra vino
+con los ojos como ají
+y empezó la pobre allí
+a bramar como una loba.
+Yo quise darle una soba
+a ver si la hacía callar,
+mas pude reflesionar
+que era malo en aquel punto,
+y por respeto al dijunto
+no la quise castigar.
+
+218
+Limpié el facón en los pastos,
+desaté mi redomón,
+monté despacio y salí
+al tranco pa el cañadón.
+
+219
+Después supe que al finao
+ni siquiera lo velaron,
+y retobao en un cuero,
+sin rezarle lo enterraron.
+
+220
+Y dicen que dende entonces,
+cuando es la noche serena
+suele verse una luz mala
+como de alma que anda en pena.
+
+221
+Yo tengo intención a veces,
+para que no pene tanto,
+de sacar de allí los güesos
+y echarlos al camposanto.
+
+
+VIII - El ser gaucho es un delito.
+
+222
+otra vez en un boliche
+estaba haciendo la tarde;
+cayó un gaucho que hacia alarde
+de guapo y peliador;
+a la llegada metió
+el pingo hasta la ramada,
+y yo sin decirle nada
+me quedé en el mostrador.
+
+223
+Era un terne de aquel pago
+que naides lo reprendía,
+que sus enriedos tenía
+con el señor comendante;
+y como era protegido,
+andaba muy entonao,
+y a cualquier desgraciao
+lo llevaba por delante.
+
+224
+¡Ah pobre! Si él mismo creiba
+que la vida le sobraba;
+ninguno diría que andaba
+aguaitándolo la muerte.
+Pero ansí pasa en el mundo,
+es ansí la triste vida:
+pa todos está escondida
+la güena o la mala suerte.
+
+225
+Se tiró al suelo; al dentrar
+le dio un empellón a un vasco,
+y me alargó un medio frasco
+diciendo: beba cuñao.
+Por su hermana, contesté.
+Que por la mía no hay cuidao.
+
+226
+¡Ah, gaucho!, Me respondió;
+¿de que pago será crioyo?
+¿Lo andará buscando el hoyo?
+Deberá tener güen cuero;
+pero ande bala este toro
+no bala ningún ternero.
+
+227
+Y ya salimos trenzaos
+porque el hombre no era lerdo,
+mas como el tino no pierdo,
+y soy medio ligerón,
+le dejé mostrando el sebo
+de un revés con el facón.
+
+228
+Y como con la justicia
+no andaba bien por allí,
+cuanto pataliar lo vi,
+y el pulpero pegó el grito,
+ya pa el palenque salí
+como haciéndome chiquito.
+
+229
+Monté y me encomendé a Dios,
+rumbiando para otro pago,
+que el gaucho que llaman vago
+no puede tener querencia,
+y ansí de estrago en estrago
+vive llorando la ausencia.
+
+230
+éL andaba siempre juyendo,
+siempre pobre y perseguido,
+no tiene cueva ni nido
+como si juera maldito;
+porque el ser gaucho- ¡barajo!,
+El ser gaucho es un delito.
+
+231
+Es como el patrio de posta;
+lo larga éste, aquél lo toma,
+nunca se acaba la broma;
+dende chico se parece
+al arbolito que crece
+desamparao en la loma.
+
+232
+Le echan la agua del bautismo
+aquél que nació en la selva;
+busca madre que te envuelva,
+le dice el fraire y lo larga.
+Y dentra a cruzar el mundo
+como burro con la carga.
+
+233
+Y se cría viviendo al viento
+como oveja sin trasquila;
+mientras su padre en las filas
+anda sirviendo al gobierno,
+aunque tirite en invierno,
+naides lo ampara ni asila.
+
+234
+Le llaman gaucho mamao
+si lo pillan divertido,
+y que es mal entretenido
+si en un baile lo sorprienden;
+hace mal si se defiende
+y si no, se ve- fundido.
+
+235
+No tiene hijos ni mujer,
+ni amigos ni protetores,
+pues todos son sus señores
+sin que ninguno lo ampare:
+tiene la suerte del güey,
+y ¿donde irá el güey que no are?
+
+236
+Su casa es el pajonal,
+su guarida es el desierto;
+y si de hambre medio muerto
+le echa el lazo a algún mamón,
+lo persiguen como a plaito,
+porque es un gaucho ladrón.
+
+237
+Y si de un golpe por ahi
+lo dan güelta panza arriba,
+no hay un alma compasiva
+que le rece una oración;
+tal vez como cimarrón
+en una cueva lo tiran.
+
+238
+Él nada gana en la paz
+y es el primero en la guerra;
+no le perdonan si yerra,
+que no saben perdonar,
+porque el gaucho en esta tierra
+sólo sirve pa votar.
+
+239
+Para el son los calabozos,
+para el las duras prisiones,
+en su boca no hay razones
+aunque la razón le sobre;
+que son campanas de palo
+las razones de los pobres.
+
+240
+Si uno aguanta, es gaucho bruto;
+si no aguanta es gaucho malo.
+¡Dele azote, dele palo,
+porque es lo que él necesita!
+De todo el que nació gaucho
+ésta es la suerte maldita.
+
+241
+Vamos suerte, vamos juntos
+dende que juntos nacimos;
+y ya que juntos vivimos
+sin podernos dividir-
+yo abriré con mi cuchillo
+el camino pa seguir
+
+
+IX - Matreriando. La lucha con la partida.
+
+242
+matreriando lo pasaba
+ya a las casas no venía;
+solía arrimarme de día,
+mas, lo mesmos que el carancho,
+siempre estaba sobre el rancho
+espiando a la polecía.
+
+243
+Viva el gaucho que ande mal,
+como zorro perseguido,
+hasta que al menor descuido
+se lo atarasquen los perros,
+pues nunca le falta un yerro
+al hombre más alvertido.
+
+244
+Y en esa hora de la tarde
+en que tuito se adormece,
+que el mundo dentrar parece
+a vivir en pura calma,
+con las tristezas del alma
+al pajonal enderiece.
+
+245
+Bala el tierno corderito
+al lao de la blanca oveja,
+y a la vaca que se aleja
+llama el ternero amarrao;
+pero el gaucho desgraciao
+no tiene a quien dar su oveja.
+
+246
+Ansí es que al venir la noche
+iba a buscar mi guarida,
+pues ande el tigre se anida
+también el hombre lo pasa,
+y no quería que en las casas
+me rodiara la partida.
+
+247
+Pues aun cuando vengan ellos
+cumpliendo con su deberes,
+yo tengo otros pareceres,
+y en esa conduta vivo:
+que no debe un gaucho altivo
+peliar entre las mujeres.
+
+248
+Y al campo me iba solito,
+más matrero que el venao,
+como perro abandonao
+a buscar una tapera,
+o en alguna vizcachera
+pasar la noche tirao.
+
+249
+Sin punto ni rumbo fijo
+en aquella inmensidá,
+entre tanta escuridá
+anda el gaucho como duende;
+allí jamás lo sorpriende
+dormido, la autoridá.
+
+250
+Su esperanza es el coraje,
+su guardia es la precaución,
+su pingo es la salvación,
+y pasa uno en su desvelo,
+sin más amparo que el cielo
+ni otro amigo que el facón.
+
+251
+Ansí me hallaba una noche
+contemplando las estrellas,
+que le parecen más bellas
+cuanto uno es más desgraciao,
+y que Dios las haiga criao
+para consolarse en ellas.
+
+252
+Les tiene el hombre cariño
+y siempre con alegría
+ve salir las tres marías;
+que si llueve, cuanto escampa,
+las estrellas son la guía
+que el gaucho tiene en la pampa.
+
+253
+Aquí no valen dotores,
+sólo vale la esperiencia;
+aquí verían su inocencia
+ésos que todo lo saben,
+porque esto tiene otra llave
+y el gaucho tiene su cencia.
+
+254
+Es triste en medio del campo
+pasarse noches enteras
+contemplando en sus carreras
+las estrellas que Dios cría,
+sin tener más compañía
+que su delito y las fieras.
+
+255
+Me encontraba como digo,
+en aquella soledá,
+entre tanta escuridá,
+echando al viento mis quejas,
+cuando el grito del chajá
+me hizo parar las orejas.
+
+256
+Como lumbriz me pegué
+al suelo para escuchar;
+pronto sentí retumbar
+las pisadas de los fletes,
+y que eran muchos jinetes
+conocí sin vacilar.
+
+257
+Cuando el hombre está en peligro
+no debe tener confianza;
+ansí tendido de panza
+puse toda mi atención
+y ya escuché sin tardanza
+como el ruido de un latón.
+
+258
+Se venían tan calladitos
+que yo me puse en cuidao;
+tal vez me hubieran bombiao
+y ya me venían a buscar;
+mas no quise disparar,
+que eso es de gaucho morao.
+
+259
+Al punto me santigüé
+y eché de giñebra un taco;
+lo mesmito que el mataco
+me arroyé con el porrón;
+si han de darme pa tabaco,
+dije, ésta es güena ocasión.
+
+260
+Me refalé las espuelas,
+para no peliar con grillos;
+me arremangué el calzoncillo,
+y me ajusté bien la faja,
+y en una mata de paja
+probé el filo del cuchillo.
+
+261
+Para tenerlo a la mano
+el flete en el pasto até,
+la cincha le acomodé,
+y, en un trance como aquél,
+haciendo espaldas en él
+quietito los aguardé.
+
+262
+Cuando cerca los sentí,
+y que ahi no más se pararon,
+los pelos se me erizaron
+y, aunque nada vían mis ojos,
+no se han de morir de antojo,
+les dije, cuando llegaron.
+
+263
+Yo quise hacerles saber
+que allí se hallaba un varón;
+les conocí la intención
+y solamente por eso
+es que les gané el tirón,
+sin aguardar voz de preso.
+
+264
+Vos sos un gaucho matrero,
+dijo uno, haciéndose el güeno.
+Vos mataste un moreno
+y otro en una pulpería,
+y aquí está la polecía
+que viene a ajustar tus cuentas;
+te va alzar por las cuarenta
+si te resistís hoy día.
+
+265
+No me vengan, contesté,
+con relación de dijuntos;
+ésos son otros asuntos;
+vean si me pueden llevar,
+que yo no me he de entregar,
+aunque vengan todos juntos.
+
+266
+Pero no aguardaron más
+y se apiaron en montón;
+como a perro cimarrón
+me rodiaron entre tantos;
+ya me encomendé a los santos,
+y eché mano a mi facón.
+
+267
+Y ya vide el fogonazo
+de un tiro de garabina,
+mas quiso la suerte indina
+de aquel maula, que me errase,
+y ahi no más lo levantase
+lo mesmo que una sardina.
+
+268
+A otro que estaba apurao
+acomodando una bola,
+le hice una dentrada sola
+y le hice sentir el Fierro,
+y ya salió como el perro
+cuando le pisan la cola.
+
+269
+Era tanta la aflición
+y la angurria que venían,
+que tuitos se me venían,
+donde yo los esperaba;
+uno al otro se estorbaba
+y con las ganas no vían.
+
+270
+Dos de ellos que traiban sables
+más garifos y resueltos,
+en las hilachas envueltos
+enfrente se me pararon,
+y a un tiempo me atropellaron
+lo mesmo que perros sueltos.
+
+271
+Me fui reculando en falso
+y el poncho adelante eché,
+y en cuanto le puso el pie
+uno medio chapetón,
+de pronto le di un tirón
+y de espaldas lo largué
+
+272
+al verse sin compañero
+el otro se sofrenó;
+entonces le dentré yo,
+sin dejarlo resollar,
+pero ya empezó a aflojar
+y a la pu-n-ta disparó.
+
+273
+Uno que en una tacuara
+había atao una tijera,
+se vino como si juera
+palenque de atar terneros,
+pero en dos tiros certeros
+salió aullando campo ajuera.
+
+274
+Por suerte en aquel momento
+venía coloriando el alba
+y yo dije: si me salva
+la virgen en este apuro,
+en adelante le juro
+ser más güeno que una malva.
+
+275
+Pegué un brinco y entre todos
+sin miedo me entreveré;
+hecho ovillo me quedé
+y ya me cargó una yunta,
+y por el suelo la punta
+de mi facón les jugué.
+
+276
+El más engolosinao
+se me apió con un hachazo;
+se lo quité con el brazo;
+de no, me mata los piojos;
+y antes de que diera un paso
+le eché tierra en los dos ojos.
+
+277
+Y mientras se sacudía
+refregándose la vista,
+yo me le fui como lista
+y ahi no más me le afirmé,
+diciéndole: Dios te asista,
+y de un revés lo voltié.
+
+278
+Pero en ese punto mesmo
+sentí que por las costillas
+un sable me hacía cosquillas
+y la sangre me heló;
+dende ese momento yo
+me salí de mis casillas.
+
+279
+Di para atrás unos pasos
+hasta que pude hacer pie;
+por delante me lo eché
+de punta y tajos a un criollo;
+metió la pata en un hoyo,
+y yo al hoyo lo mandé.
+
+280
+Tal vez en el corazón
+le tocó un santo bendito
+a un gaucho, que pegó el grito
+y dijo: ¡Cruz no consiente
+que se cometa el delito
+de matar a un valiente!
+
+281
+Y ahi no más se me aparió,
+dentrándole a la partida;
+yo les hice otra embestida
+pues entre dos era robo;
+y el Cruz era como lobo
+que defiende su guarida.
+
+282
+Uno despachó al infierno
+de dos que lo atropellaron;
+los demás remoliniaron,
+pues íbamos a la fija,
+y a poco andar dispararon
+lo mesmo que sabandija.
+
+283
+Ahí quedaron largo a largo
+los que estiaron la jeta;
+otro iba como maleta,
+y Cruz de atrás les decía:
+que venga otra polecía
+a llevarlos en carreta.
+
+284
+Yo junté las osamentas,
+me hinqué y les recé un bendito,
+hice una cruz de un palito
+y pedí a mi Dios clemente
+me perdonara el delito
+de haber muerto tanta gente.
+
+285
+Dejamos amotonaos
+a los pobres que murieron;
+no sé si los recogieron,
+porque nos fuimos a un rancho,
+o si tal vez los caranchos
+ahi no más se los comieron.
+
+286
+Lo agarramos mano a mano
+entre los dos al porrón:
+en semejante ocasión
+un trago a cualquiera encanta;
+y Cruz no era remolón
+ni pijotiaba garganta.
+
+287
+Calentamos los gargueros
+y nos largamos muy tiesos,
+siguiendo siempre los besos
+al pichel, y por mas señas,
+íbamos como cigüeñas
+estirando los pescuezos.
+
+288
+Yo me voy, le dije, amigo,
+donde la suerte me lleve,
+y si es que alguno se atreve,
+a ponerse en mi camino,
+yo seguiré mi destino,
+que el hombre hace lo que debe.
+
+289
+Soy un gaucho desgraciao,
+no tengo donde ampararme,
+ni un palo donde rascarme,
+ni un árbol que me cubije:
+pero ni aun esto me aflige
+porque yo sé manejarme.
+
+290
+Antes de cair al servicio,
+tenia familia y hacienda;
+cuando volví, ni la prenda
+me la habían dejao ya.
+Dios sabe en lo que vendrá
+a parar esta contienda.
+
+
+X - Por culpa de una mujer.
+
+291
+amigazo, pa sufrir
+han nacido los varones;
+estas son las ocasiones
+de mostrarse un hombre juerte,
+hasta que venga la muerte
+y lo agarre a coscorrones.
+
+292
+El andar tan despilchao
+ningún mérito me quita;
+sin ser un alma bendita
+me duelo del mal ajeno:
+soy un pastel con relleno
+que parece torta frita.
+
+293
+Tampoco me faltan males
+y desgracias, le prevengo;
+también mis desdichas tengo,
+aunque esto poco me aflige:
+yo sé hacerme el chango rengo
+cuando la cosa lo esige.
+
+294
+Y con algunos ardiles
+voy viviendo, aunque rotoso;
+a veces me hago el sarnoso
+y no tengo ni un granito,
+pero al chifle voy ganoso
+como panzón al maíz frito.
+
+295
+A mí no me matan penas
+mientras tenga el cuero sano;
+venga el sol en el verano
+y la escarcha en el invierno
+¿por qué afligirse el cristiano?
+
+296
+Hagámosle cara fiera
+a los males, compañero,
+porque el zorro más matrero
+suele cair como un chorlito;
+viene por un corderito
+y en la estaca deja el cuero.
+
+297
+Hoy tenemos que sufrir
+males que no tienen nombre,
+pero esto a nadies lo asombre
+porque ansina es el pastel,
+y tiene que dar el hombre
+mas güeltas que un carretel.
+
+298
+Yo nunca me he de entregar
+a los brazos de la muerte;
+arrastro mi triste suerte
+paso a paso y como pueda,
+que donde el débil se queda
+se suele escapar el juerte.
+
+299
+Y ricuerde cada cual
+lo que cada cual sufrió,
+que lo que es, amigo, yo,
+hago ansí la cuenta mía:
+ya lo pasado pasó;
+mañana será otro día.
+
+300
+Yo también tuve una pilcha
+que me enllenó el corazón,
+y si en aquella ocasión
+alguien me hubiera buscao,
+siguro que me había hallao
+más prendido que un botón.
+
+301
+En la güeya del querer
+no hay animal que se pierda-
+las mujeres no son lerdas,
+y todo gaucho es dotor
+si pa cantarle al amor
+tiene que templar las cuerdas.
+
+302
+¡Quién es de una alma tan dura
+que no quiera una mujer!
+Lo alivia en su padecer:
+si no sale calavera
+es la mejor compañera
+que el hombre puede tener.
+
+303
+Si es güena, no lo abandona
+cuando lo ve desgraciao,
+lo asiste con su cuidao,
+y con afán cariñoso,
+y usté tal vez ni un rebozo
+ni una pollera le ha dao.
+
+304
+¡Grandemente lo pasaba
+con aquella prenda mía,
+viviendo con alegría
+como la mosca en la miel!
+¡Amigo, qué tiempo aquel!
+¡La pucha, que la quería!
+
+305
+Era la águila que a un árbol
+dende las nubes bajó;
+era más linda que el alba
+cuando va rayando el sol;
+era la flor deliciosa
+que entre el trebolar creció.
+
+306
+Pero, amigo, el comendante
+que mandaba la milicia,
+como que no desperdicia
+se fue refalando a casa;
+yo le conocí en la traza
+que el hombre traiba malicia.
+
+307
+Él me daba voz de amigo,
+pero no le tenía fe;
+era el jefe, y ya se ve,
+no podía competir yo;
+en mi rancho se pegó
+lo mesmo que un saguaipé.
+
+308
+A poco andar, conocí
+que ya me había desbancao,
+y él siempre muy entonao,
+aunque sin darme ni un cobre,
+me tenía de lao a lao
+como encomienda de pobre.
+
+309
+A cada rato, de chasque
+me hacía dir a gran distancia;
+ya me mandaba a una estancia,
+ya al pueblo, ya a la frontera;
+pero él en la comendancia
+no ponía los pies siquiera.
+
+310
+Es triste a no poder más
+el hombre en su padecer,
+si no tiene una mujer
+que lo ampare y lo consuele:
+mas pa que otro se la pele
+lo mejor es no tener.
+
+311
+No me gusta que otro gallo
+le cacaree a mi gallina;
+yo andaba ya con la espina,
+hasta que en una ocasión
+lo pille junto al jogón
+abrazándome a la china.
+
+312
+Tenía el viejito una cara
+de ternero mal lamido,
+y al verle tan atrevido
+le dije: ¡que le aproveche!-
+Que había sido pa el amor
+como gaucho pa la leche.
+
+313
+Peló la espalda y se vino
+como a quererme ensartar,
+pero yo sin tutubiar
+le volví al punto a decir:
+¡cuidado!, No te vas a per-tigo;
+poné cuarta pa salir.
+
+314
+Un puntazo me largó,
+pero el cuerpo le saqué,
+y en cuanto se lo quité,
+para no matar un viejo,
+con cuidado, medio de lejos
+un palazo le asenté.
+
+315
+Y como nunca al que manda
+le falta algún adulón,
+uno que en esa ocasión
+se encontraba allí presente,
+vino apretando los dientes
+como perrito mamón.
+
+316
+Me hizo un tiro de revuélver
+que el hombre creyó siguro;
+era confiado y le juro
+que cerquita se arrimaba,
+pero, siempre en un apuro
+se desentumen mis tabas.
+
+317
+Él me siguió menudiando
+mas sin poderme acertar,
+y yo, dele culebriar,
+hasta que al fin le dentré
+y ahi no más lo despaché
+sin dejarlo resollar.
+
+318
+Dentré a campiar en seguida
+al viejito enamorao-
+el pobre se había ganao
+en un noque de lejía.
+¡Quién sabe cómo estaría
+del susto que había llevao!
+
+319
+¡Es zonzo el cristiano macho
+cuando el amor lo domina!
+Él la miraba a la indina,
+y una cosa tan jedionda
+sentí yo, que ni en la fonda
+he visto tal jedentina
+
+320
+Y le dije: pa su agüela
+han de ser esas perdices.
+Yo me tapé las narices,
+y me salí esternudando,
+y el viejo quedó olfatiando
+como chico con lumbrices.
+
+321
+Cuando la mula recula,
+señal que quiere cociar,
+ansí se suele portar
+aunque ella lo disimula;
+recula como la mula
+la mujer, para olvidar.
+
+322
+Alcé mis ponchos y mis prendas
+y me largué a padecer
+por culpa de una mujer
+que quiso engañar a dos;
+al rancho le dije adiós,
+para nunca más volver.
+
+323
+Las mujeres, dende entonces,
+conocí a todas en una;
+ya no he de probar fortuna
+con carta tan conocida:
+mujer y perra parida,
+¡no se me acerca ninguna!.
+
+
+XI - A bailar un pericón.
+
+324
+a otros les brotan las coplas
+como agua de manantial;
+pues a mí me pasa igual;
+aunque las mías nada valen,
+de la boca se me salen
+como ovejas de corral.
+
+325
+Que en puertiando la primera,
+ya la siguen los demás,
+y en montones las de atrás
+contra los palos se estrellan,
+y saltan y se atropellan
+sin que se corten jamás.
+
+326
+Y aunque yo por mi inorancia
+con gran trabajo me esplico,
+cuando llego a abrir el pico,
+tengaló por cosa cierta,
+sale un verso y en la puerta
+ya asoma el otro el hocico.
+
+327
+Y emprésteme su atención;
+me oirá relatar las penas
+de que traigo la alma llena;
+porque en toda circustancia,
+paga el gaucho su inorancia
+con la sangre de sus venas.
+
+328
+Después de aquella desgracia
+me refugié en los pajales;
+anduve entre los cardales
+como bicho sin guarida;
+pero, amigo, es esa vida
+como vida de animales.
+
+329
+Y son tantas las miserias
+en que me he salido ver,
+que con tanto padecer
+y sufrir tanta aflición,
+malicio que he de tener
+un callo en el corazón.
+
+330
+Ansí andaba como guacho
+cuando pasa el temporal;
+supe una vez por mi mal
+de una milonga que había,
+y ya pa la pulpería
+enderecé mi bagual.
+
+331
+Era la casa del baile
+un rancho de mala muerte,
+y se enllenó de tal suerte
+que andábamos a empujones:
+nunca faltan encontrones
+cuando un pobre se divierte.
+
+332
+Yo tenía unas medias botas
+con tamaños verdugones;
+me pusieron los talones
+con crestas como gallos:
+¡si viera mis afliciones
+pensando yo que eran callos!
+
+333
+Con gato y con fandanguillo
+había empezado el changango,
+y para ver el fandango
+me colé haciendomé bola,
+mas metió el diablo la cola,
+y todo se volvió pango.
+
+334
+Había sido el guitarrero
+un gaucho duro de boca:
+yo tengo paciencia poca
+pa aguantar cuando no debo;
+a ninguno me le atrevo,
+pero me halla el que me toca.
+335
+A bailar un pericón
+con una moza salí,
+y cuanto me vido allí
+sin duda me conoció;
+y estas coplitas cantó
+como por raírse de mí:
+
+336
+las mujeres son todas
+como las mulas;
+yo no digo que todas,
+pero hay algunas
+que a las aves que vuelan
+les sacan plumas.
+
+337
+Hay gauchos que presumen
+de tener damas;
+no digo que presumen,
+pero se alaban,
+y a lo mejor los dejan
+tocando tablas.
+
+338
+Se secretiaron las hembras,
+y yo ya me encocoré;
+volié la anca y le grité:
+¡dejá de cantar- chicharra!
+Y de un tajo a la guitarra
+tuitas las cuerdas corté.
+
+339
+Al punto salió de adentro
+un gringo con un jusil;
+pero nunca he sido vil,
+poco el peligro me espanta;
+yo me refalé la manta
+y la eché sobre el candil.
+
+340
+Gané en seguida la puerta
+gritando: ¡nadies me ataje!
+Y alborotado el hembraje,
+lo que todo quedo escuro,
+empezó a verse en apuro
+mesturao con el gauchaje.
+
+341
+El primero que salió
+fue el cantor, y se me vino;
+pero yo no pierdo el tino
+aunque haiga tomao un trago,
+y hay algunos por mi pago
+que me tienen por ladino.
+
+342
+No ha de haber achocao otro:
+le salió cara la broma;
+a su amigo cuando toma
+se le despeja el sentido,
+y el pobrecito había sido
+como carne de paloma.
+
+343
+Para prestar un socorro
+las mujeres no son lerdas:
+antes que la sangre pierda
+lo arrimaron a unas pipas;
+ahi lo dejé con las tripas
+como pa que hiciera cuerdas.
+
+344
+Monté y me largué a los campos
+más libre que el pensamiento,
+como las nubes al viento
+a vivir sin paradero,
+que no tiene el que es matrero
+nido, ni rancho, ni asiento.
+
+345
+No hay juerza contra el destino
+que le ha señalao el cielo,
+y aunque no tenga consuelo,
+¡aguante el que está en trabajo!
+¡Nadies se rasca pa abajo,
+ni se lonjea contra el pelo!
+
+346
+Con el gaucho desgraciao
+no hay uno que no se entone
+¡la menor falta lo espone
+a andar con los avestruces
+faltan otros con más luces
+y siempre hay quien los perdone.
+
+
+XII - Ansí estuve en la partida.
+
+347
+Yo no sé qué tantos meses
+esta vida me duró;
+a veces nos obligó
+la miseria a comer potro:
+me había acompañao con otros
+tan desgraciaos como yo
+
+348
+Mas ¿para qué platicar
+sobre esos males, canejos?
+Nace el gaucho y se hace viejo,
+sin que mejore su suerte,
+hasta que por ahi la muerte
+sale a cobrarle el pellejo.
+
+349
+Pero como no hay desgracia
+que no acabe alguna vez,
+me aconteció que después
+de sufrir tanto rigor,
+un amigo, por favor,
+me compuso con el juez.
+
+350
+Le alvertiré que en mi pago
+ya no va quedando un criollo:
+se los ha tragao el hoyo,
+o juido o muerto en la guerra;
+porque, amigo, en esta tierra
+nunca se acaba el embrollo.
+
+351
+Colijo que jué por eso
+que me llamó el juez un día,
+y me dijo que quería
+hacerme a su lao venir,
+y que dentrase a servir
+de soldao de polecía.
+
+352
+Y me largó una proclama
+tratándome de valiente;
+que yo era un hombre decente,
+y que dende aquel momento
+me nombraba de sargento
+pa que mandara la gente.
+
+353
+Ansí estuve en la partida,
+pero ¿qué había de mandar?
+Anoche al irlo a tomar
+vide güena coyontura,
+y a mí no me gusta andar
+con la lata a la cintura.
+
+354
+Ya conoce, pues, quién soy;
+tenga confianza conmigo:
+Cruz le dio mano de amigo,
+y no lo ha de abandonar;
+juntos podemos buscar
+pa los dos un mesmo abrigo.
+
+355
+Andaremos de matreros
+si es preciso pa salvar;
+nunca nos ha de faltar
+ni un güen pingo pa juir,
+ni un pajal ande dormir,
+ni un matambre que ensartar.
+
+356
+Y cuando sin trapo alguno
+nos haiga el tiempo dejao,
+yo le pediré emprestao
+el cuero a cualquiera lobo,
+y hago un poncho, si lo sobo,
+mejor que poncho engomao.
+
+357
+Para mí la cola es pecho
+y el espinazo es cadera
+hago mi nido ande quiera
+y de lo que encuentro como;
+me echo tierra sobre el lomo
+y me apeo en cualquier tranquera.
+
+358
+Y dejo rodar la bola,
+que algún día se ha de parar-
+tiene el gaucho que aguantar
+hasta que lo trague el hoyo,
+o hasta que venga algún criollo
+en esta tierra a mandar.
+
+362
+Todos se güelven proyetos
+de colonias y carriles,
+y tirar la plata a miles
+en los gringos enganchaos,
+mientras al pobre soldao
+le pelan la cucha- ¡ah, viles!
+
+363
+Pero si siguen las cosas
+como van hasta el presente,
+puede ser que redepente
+veamos el campo disierto,
+y blanquiando solamente
+los güesos de los que han muerto.
+
+359
+Lo miran al pobre gaucho
+como carne de cogote:
+lo tratan al estricote
+y si ansí las cosas andan,
+porque quieren los que mandan,
+aguantemos los azotes.
+
+360
+¡Pucha! Si usté los oyera,
+como yo en una ocasión
+tuita la conversación
+que con otro tuvo el juez;
+le asiguro que esa vez
+se me achicó el corazón.
+
+361
+Hablaban de hacerse ricos
+con campos en la fronteras,
+de sacarla más ajuera,
+donde había campos baldidos
+y llevar de los partidos
+gente que la defendiera.
+
+364
+Hace mucho que sufrimos
+la suerte reculativa
+trabaja el gaucho y no arriba
+porque a lo mejor del caso,
+lo levantan de un sogazo
+sin dejarle ni saliva.
+
+365
+De los males que sufrimos
+hablan mucho los puebleros,
+pero hacen como los teros
+para esconder sus niditos:
+en un lao pegan los gritos
+y en otro tienen los güevos.
+
+366
+Y se hacen los que no aciertan
+a dar con la coyontura:
+mientras al gaucho lo apura
+con rigor la autoridá,
+ellos a la enfermedá
+le están errando la cura.
+

data/martin-fierro_validation.txt

@@ -0,0 +1,234 @@
+XIII. A los indios me refalo
+
+367
+ya veo que somos los dos
+astillas del mesmo palo:
+yo paso por gaucho malo
+y usté anda del mesmo modo;
+y yo, pa acabarlo todo,
+a los indios me refalo.
+
+368
+Pido perdón a mi Dios
+que tantos bienes me hizo,
+pero dende que es preciso
+que viva entre los infeles,
+yo seré cruel con los crueles:
+ansí mi suerte lo quiso.
+
+369
+Dios formó lindas las flores,
+delicadas como son;
+le dio toda perfeción
+y cuanto él era capaz,
+pero al hombre le dio más
+cuando le dio el corazón.
+
+370
+Le dio claridá a la luz,
+juerza en su carrera al viento,
+le dio vida y movimiento
+dende la águila al gusano;
+pero más le dio al cristiano
+al darle el entendimiento.
+
+371
+Y aunque a las aves les dio,
+con otras cosas que inoro,
+esos piquitos como oro
+y un plumaje como tabla
+le dio al hombre más tesoro
+al darle una lengua que habla.
+
+372
+Y dende que dio a las fieras
+esa juria tan inmensa,
+que no hay poder que las venza
+ni nada que las asombre,
+¿qué menos le daría al hombre
+que el valor pa su defensa?
+
+373
+Pero tantos bienes juntos
+al darle, malicio yo
+que en sus adentros pensó
+que el hombre los precisaba
+que los bienes igualaba
+con las penas que le dio.
+
+374
+Y yo empujao por las mías
+quiero salir de este infierno:
+ya no soy pichón muy tierno
+y sé manejar la lanza,
+y hasta los indios no alcanza
+la facultá de gobierno
+
+375
+yo sé que allá los caciques
+amparan a los cristianos,
+y que los tratan de
+cuando se van por su gusto.
+¡A qué andar pasando sustos-!
+Alcemos el poncho y vamos.
+
+376
+En la cruzada hay peligros,
+pero ni aun esto me aterra:
+yo ruedo sobre la tierra
+arrastrao por mi destino;
+y si erramos el camino-
+no es el primero que lo erra.
+
+377
+Si hemos de salvar o no,
+de esto naides nos responde;
+derecho ande el sol se esconde
+tierra adentro hay que tirar;
+algún día hemos de llegar-
+después sabremos a dónde.
+
+378
+No hemos de perder el rumbo:
+los dos somos güena yunta.
+El que es gaucho ve ande apunta
+aunque inora ande se encuentra;
+pa el lao en que el sol se dentra
+dueblan los pastos la punta.
+
+379
+De hambre no pereceremos,
+pues, sigún otros me han dicho,
+en los campos se hallan bichos
+de los que uno necesita-
+gamas, matacos, mulitas
+avestruces y quirquinchos.
+
+380
+Cuando se anda en el desierto
+se come uno hasta las colas;
+lo han cruzao mujeres solas
+llegando al fin con salú,
+y ha de ser gaucho el ñandú
+que se escape de mis bolas.
+
+381
+Tampoco a la sé le temo;
+yo la aguanto muy contento;
+busco agua olfatiando el viento
+y, dende que no soy manco,
+ande hay duraznillo blanco
+cavo, y la saco al momento.
+
+382
+Allá habrá siguridá
+ya que aquí no la tenemos;
+menos males pasaremos
+y ha de haber grande alegría
+el día que nos descolguemos
+en alguna toldería.
+
+383
+Fabricaremos un toldo,
+como lo hacen tantos otros,
+con unos cueros de potro,
+que sea sala y sea cocina.
+¡Tal vez no falte una china
+que se apiade de nosotros!
+
+384
+Allá no hay que trabajar,
+vive uno como un señor;
+de cuando en cuando un malón,
+y si de él sale con vida,
+lo pasa echao panza arriba
+mirando dar güelta el sol
+
+385
+Y ya que a juerza de golpes
+la suerte nos dejó aflús
+puede que allá veamos luz
+y se acaben nuestras penas:
+todas las tierras son güenas;
+vamonós, amigo Cruz.
+
+386
+El que maneja las bolas,
+el que sabe echar un pial
+y sentársele a un bagual
+sin miedo de que lo baje,
+entre los mesmos salvajes
+no puede pasarlo mal.
+
+387
+El amor como la guerra
+lo hace el criollo con canciones;
+a más de eso en los malones
+podemos aviarnos de algo;
+en fin amigo, yo salgo
+de estas pelegrinaciones.
+
+388
+En este punto el cantor
+buscó un porrón pa consuelo,
+echó un trago como un cielo,
+dando fin a su argumento;
+y de un golpe el instrumento
+lo hizo astillas contra el suelo.
+
+389
+Ruempo, dijo, la guitarra,
+pa no volverme a tentar;
+ninguno la ha de tocar,
+por siguro tengaló;
+pues naides ha de cantar
+cuando este gaucho cantó.
+
+390
+Y daré fin a mis coplas
+con aire de relación;
+nunca falta un preguntón
+más curioso que mujer,
+y tal vez quiera saber
+como jué la conclusión.
+
+391
+Cruz y Fierro de una estancia
+una tropilla se arriaron;
+por delante se la echaron
+como criollos entendidos,
+y pronto sin ser sentidos
+por la frontera cruzaron.
+
+392
+Y cuando la habían pasao,
+una madrugada clara
+le dijo Cruz que mirara
+las últimas poblaciones,
+y a Fierro dos lagrimones
+le rodaron por la cara.
+
+393
+Y siguiendo el fiel del rumbo
+se entraron en el desierto,
+no sé si los habrán muerto
+en alguna correría,
+pero espero que algún día
+sabré de ellos algo cierto.
+
+394
+Y ya con estas noticias
+mi relación acabé;
+por ser ciertas las conté,
+todas la desgracias dichas:
+es un telar de desdichas
+cada gaucho que usté ve.
+
+395
+Pero ponga su esperanza
+en el Dios que lo formó;
+y aquí me despido yo
+que he relatao a mi modo
+MALES QUE CONOCEN TODOS,
+PERO QUE NAIDES CONTÓ.
+

flisol-cordoba-2023.ipynb

@@ -0,0 +1,1164 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "65c9fdf3",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "Hugging Face: IA Colaborativa\n",
+    "========================="
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "32a802c2",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "¿Quién soy?\n",
+    "------------------\n",
+    "\n",
+    "<div style=\"text-align:center\">\n",
+    "    <h4 style=\"font-size:1.5em;margin:5px\">Cristian Cardellino</h4>\n",
+    "    <h5 style=\"font-style:normal;font-size:1em;margin:5px\">Profesor de FAMAFyC (UNC) - Investigador en Mercado Libre</h5>\n",
+    "    <div style=\"display:inline-block;margin-right:0px;\">\n",
+    "        <img src=\"./img/me.jpg\" style=\"height:10em;width:auto;\"/>\n",
+    "    </div>\n",
+    "    <h6 style=\"font-style:normal;font-size:0.9em;margin:5px;\">\n",
+    "        <a href=\"https://twitter.com/crscardellino\" style=\"color:royalblue;\" target=\"_blank\">@crscardellino</a> -\n",
+    "        <a href=\"https://mastodon.social/@crscardellino\" style=\"color:royalblue;\" target=\"_blank\">@crscardellino@mastodon.social</a> -\n",
+    "        <a href=\"https://crscardellino.ar\" style=\"color:royalblue;\" target=\"_blank\">https://crscardellino.ar</a>\n",
+    "    </h6>\n",
+    "</div>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bb685a55",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## Esquema de la charla\n",
+    "\n",
+    "1. [¿Qué hay detrás de ChatGPT?](#¿Qué-hay-detrás-de-ChatGPT?)\n",
+    "2. [Hugging Face](#Hugging-Face)\n",
+    "3. [Utilizando un modelo de Hugging Face](#Utilizando-un-modelo-de-Hugging-Face)\n",
+    "4. [Personalizando un modelo de Hugging Face](#Personalizando-un-modelo-de-Hugging-Face)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "eb7f3997",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "# ¿Qué hay detrás de ChatGPT?"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "87d1ca59",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Cómo continúa esta frase?\n",
+    "\n",
+    "<h2 style=\"text-align:center;font-weight:normal;font-size:1.3em;\">You ...</h2>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1e5a5c6b",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "source": [
+    "<h2 style=\"text-align:center;font-weight:normal;font-size:1.3em;\">You shall ...</h2>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f71da59e",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "source": [
+    "<h2 style=\"text-align:center;font-weight:normal;font-size:1.3em;\">You shall not ...</h2>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2910e985",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "source": [
+    "<div style=\"text-align:center;\">\n",
+    "    <h2 style=\"font-weight:normal;font-size:1.3em;\">You shall not pass!</h2>\n",
+    "    <div style=\"display:inline-block;margin-top:10px;\">\n",
+    "        <img src=\"./img/gandalf.gif\" style=\"height:10em;width:auto;\"/>\n",
+    "    </div>\n",
+    "</div>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "283ca08c",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Qué son los \"modelos de lenguaje\"? (Language Models)\n",
+    "\n",
+    "- Modelos de aprendizaje automático.\n",
+    "- Dado un contexto (e.g. una lista de palabras previas), predicen la palabra siguiente.\n",
+    "- Se entrenan con texto libre."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "778b5e91",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "source": [
+    "### ¿Qué son los \"LLMs\"? (Large Language Models)\n",
+    "\n",
+    "- Modelos de lenguajes entrenados con una gran cantidad de datos y de parámetros:\n",
+    "    - Suelen entrenarse con corpus del orden de $10^{10}$ palabras.\n",
+    "    - Suelen tener de $10^8$ o $10^9$ parámetros en adelante.\n",
+    "- El término se asocia generalmente a aquellos modelos basados en la arquitectura neuronal del **Transformer**."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "cfc710ea",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Qué es un \"Transformer\"?\n",
+    "\n",
+    "- Es una arquitectura de red neuronal que se presentó en el paper [\"Attention is All You Need\"](https://arxiv.org/abs/1706.03762).\n",
+    "- Existen variantes, de acuerdo a que parte de la arquitectura usan:\n",
+    "    - Los modelos de traducción de secuencia a secuencia (e.g. el [Transformer](https://arxiv.org/abs/1706.03762) o el [T5](https://arxiv.org/abs/1910.10683)). Tienen codificador y decodificador. Sirven para tareas de transformación (e.g. traducción).\n",
+    "    - Los modelos basados en el codificador (e.g. [BERT](https://arxiv.org/abs/1810.04805)). Sirven para buscar representaciones vectoriales (embeddings) del texto.\n",
+    "    - Los modelos basados en el decodificador (e.g. [GPT](https://arxiv.org/abs/2005.14165)). Sirven para generación de texto.\n",
+    "- La idea del transformer es \"definir\" una palabra de acuerdo a la relación que tiene con las palabras de su vecindario, en una operación de multiplicación matricial con pesos.\n",
+    "    - Para una explicación más sencilla pero más detallada sugiero los posts de la serie \"The Illustrated...\" de [Jay Alammar](http://jalammar.github.io/):\n",
+    "        - [The Illustrated Transformer](http://jalammar.github.io/illustrated-transformer/)\n",
+    "        - [The Illustrated BERT](http://jalammar.github.io/illustrated-bert/)\n",
+    "        - [The Illustrated GPT-2](http://jalammar.github.io/illustrated-gpt2/) / [How GPT-3 Works](http://jalammar.github.io/how-gpt3-works-visualizations-animations/)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8958cf42",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "# Hugging Face"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6038bd78",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Qué es Hugging Face?\n",
+    "\n",
+    "- Una [comunidad colaborativa](https://huggingface.co/) para hacer Inteligencia Artificial (IA).\n",
+    "- Cuenta con repositorios para subir [modelos](https://huggingface.co/models), [datasets](https://huggingface.co/datasets) y [demos](https://huggingface.co/spaces).\n",
+    "- Además, ofrecen varias librerías orientadas a la IA, particularmente al Aprendizaje Profundo (Deep Learning), entre las que destacan:\n",
+    "    - [`transformers`](https://huggingface.co/docs/transformers): La que veremos en esta charla, para todo lo relacionado a NLP con LLMs.\n",
+    "    - [`datasets`](https://huggingface.co/docs/datasets): Una librería especializada en el tratamiento de los conjuntos de datos a utilizar para entrenar/ajustar los LLMs.\n",
+    "    - [`tokenizers`](https://huggingface.co/docs/tokenizers): Para el proceso de \"tokenización\", i.e. la división de texto de manera discreta en palabras o subpalabras.\n",
+    "- Hugging Face no sólo ofrece soluciones sobre NLP, sino que también lo hace con imágenes, con librerías como [`diffusers`](https://huggingface.co/docs/diffusers), para la generación de imágenes:\n",
+    "    - Lectura recomendada: [The Illustrated Stable Diffusion](http://jalammar.github.io/illustrated-stable-diffusion/)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "25ad7d45",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Cómo empezar con Hugging Face?\n",
+    "\n",
+    "- Primero se [crea una cuenta en la página](https://huggingface.co/join).\n",
+    "- Luego podemos [crear modelos](https://huggingface.co/new) a través del menú que se despliega de nuestro avatar.\n",
+    "- Una vez creado el modelo, este es un repositorio de git que puede accederse clonándolo localmente.\n",
+    "    - Requiere de [`git-lfs`](https://git-lfs.com/)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3c6f89c3",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "# Utilizando un modelo de Hugging Face"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d06c7318",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## Cargando los modelos\n",
+    "\n",
+    "- Hugging Face ofrece muchísimos modelos en su [repositorio](https://huggingface.co/models), para este caso elegimos el modelo [`bigscience/bloom-3b`](https://huggingface.co/bigscience/bloom-3b) de la organización [Big Science](https://bigscience.huggingface.co/blog/bloom).\n",
+    "    - Esta organización ha estado [creando modelos](https://huggingface.co/bigscience) bajo una [licencia abierta](https://bigscience.huggingface.co/blog/the-bigscience-rail-license) (con ciertas limitaciones de uso para evitar abuso).\n",
+    "    - Son responsables del [LLM abierto más grande actualmente disponible](https://huggingface.co/bigscience/bloom).\n",
+    "- El modelo elegido es un modelo de 3 mil millones (3 billion) de parámetros."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "0e0d53be",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import torch\n",
+    "\n",
+    "from IPython.display import display, HTML\n",
+    "from transformers import AutoModelForCausalLM, AutoTokenizer\n",
+    "\n",
+    "BASE_MODEL = 'bigscience/bloom-3b'  # More models at https://huggingface.co/models\n",
+    "\n",
+    "tokenizer = AutoTokenizer.from_pretrained(BASE_MODEL)\n",
+    "model = AutoModelForCausalLM.from_pretrained(\n",
+    "    BASE_MODEL,\n",
+    "    low_cpu_mem_usage=True,\n",
+    "    torch_dtype='auto'\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "022de9b5",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## Generando Texto a Partir de un PROMPT\n",
+    "\n",
+    "- Los modelos de lenguaje necesitan una semilla, denominada comúnmente **prompt**, para iniciar su conversación.\n",
+    "- A partir de dicha semilla, los modelos pueden empezar a predecir las palabras siguiente.\n",
+    "- La coherencia de la frase depende de varios aspectos:\n",
+    "    - El tamaño y [entrenamiento](https://github.com/huggingface/notebooks/blob/main/examples/language_modeling_from_scratch.ipynb) o [ajuste](https://github.com/huggingface/notebooks/blob/main/examples/language_modeling.ipynb) (fine-tuning) del modelo.\n",
+    "        - Modelos más grandes suelen ser mejor en escenarios \"open end\", aunque pueden desvariar (o \"alucinar\").\n",
+    "    - El tipo de datos con el que se entrenó/ajustó el modelo.\n",
+    "    - La [estrategia](https://github.com/huggingface/blog/blob/main/notebooks/02_how_to_generate.ipynb) a la hora de generar texto.\n",
+    "    - La [documentación de Hugging Face](https://huggingface.co/docs/transformers/notebooks) tiene más ejemplos que pueden reproducirse."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e89d104b",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Estableciendo un PROMPT\n",
+    "\n",
+    "- El **prompt** inicial es el que \"ayudará\" al modelo a devolver resultados más o menos coherentes.\n",
+    "- Actualmente es más un arte que una ciencia.\n",
+    "    - **No existe el \"prompt engineering\" porque los modelos no son determinísticos.**\n",
+    "- Depende muchísimo del modelo, la inicialización aleatoria (i.e. la suerte), la tarea que se busca resolver, entre otros factores.\n",
+    "- Algo bastante común es que se le den ejemplos concretos de cómo se espera que genere texto.\n",
+    "    - A esta práctica se le conoce como [\"Few Shot Learning\"](https://arxiv.org/abs/2005.14165), si bien el modelo no \"aprende\" sino que busca contextos similares a los vistos en los ejemplos."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e6b4464",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Ejemplo de PROMPT\n",
+    "\n",
+    "- Siguiendo los ejemplos de [esta publicación](https://medium.com/@fractal.ai/create-conversational-agents-using-bloom-part-1-63a66e6321c0), y en vistas de armar un chatbot, buscaré definir 4 cosas:\n",
+    "    - La \"identidad\", i.e. ¿Qué es?\n",
+    "    - La \"intención\", i.e. ¿Qué hace?\n",
+    "    - El \"comportamiento\", i.e. ¿Cómo lo hace?\n",
+    "    - Además le daré pie a que continué una conversación (\"Few Shot Learning\")."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "c1227c49",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "PROMPT = \"\"\"\n",
+    "La siguiente es una conversación entre un HUMANO y un bot EXPERTO en software libre.\n",
+    "El EXPERTO le ayuda al HUMANO con preguntas acerca de software libre.\n",
+    "El EXPERTO es conversacional, optimista, flexible, creativo y genera respuestas parecidas a un humano.\n",
+    "\n",
+    "HUMANO: Hola, ¿Cómo estás?\n",
+    "EXPERTO: Hola, muy bien. Estoy acá para ayudarte con preguntas respecto al software libre.\n",
+    "\n",
+    "HUMANO: ¿Qué es el software libre?\n",
+    "EXPERTO:\"\"\".strip()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "82988db2",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Generando texto de manera \"Greedy\"\n",
+    "\n",
+    "- La estrategia para generar texto puede variar. La opción más directa es **greedy**, i.e. devolver la palabra que es más probable después de la secuencia.\n",
+    "    - La principal ventaja de esta alternativa, es que es determinística, i.e. ante la misma entrada debería devolver la misma salida.\n",
+    "    - La principal desventaja es que tiende a repetir y quedar limitada a ciertas frases o palabras."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "11bec6de",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "La siguiente es una conversación entre un HUMANO y un bot EXPERTO en software libre.\n",
+      "El EXPERTO le ayuda al HUMANO con preguntas acerca de software libre.\n",
+      "El EXPERTO es conversacional, optimista, flexible, creativo y genera respuestas parecidas a un humano.\n",
+      "\n",
+      "HUMANO: Hola, ¿Cómo estás?\n",
+      "EXPERTO: Hola, pmuy bien. Estoy acá para ayudarte con preguntas respecto al software libre.\n",
+      "\n",
+      "HUMANO: ¿Qué es el software libre?\n",
+      "EXPERTO: El software libre es un software que se puede modificar, redistribuir y distribuir libremente.\n",
+      "HUMANO: ¿En qué consiste la licencia GPL?\n",
+      "EXPERTO: La licencia GPL es una licencia de software libre que permite a los usuarios modificar, redistribuir\n"
+     ]
+    }
+   ],
+   "source": [
+    "MAX_TOKENS = 50\n",
+    "input_ids = tokenizer.encode(PROMPT, return_tensors='pt')\n",
+    "greedy_output = model.generate(input_ids, max_length=input_ids.shape[1] + MAX_TOKENS)\n",
+    "output = tokenizer.decode(greedy_output[0], skip_special_tokens=True)\n",
+    "\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ba05a269",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Generando texto usando aleatoriedad\n",
+    "\n",
+    "- Si bien hay [varias estrategias para generar texto libre](https://github.com/huggingface/blog/blob/main/notebooks/02_how_to_generate.ipynb) una que resulta muy interesante es mediante el sampleo estadístico.\n",
+    "- La idea es que la manera de seleccionar la siguiente palabra es con cierta probabilidad estadística (i.e. no siempre la más probable).\n",
+    "    - La principal ventaja es que hace el texto más \"creativo\" y más \"humano\".\n",
+    "    - La principal desventaja es que no es determinístico y es suceptible de \"alucinar\".\n",
+    "    - En este caso se samplea de las `top_k` palabras más probable que a su vez son la menor cantidad de palabras cuya probabilidad conjunta es mayor que `top_p`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "dc66f288",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "La siguiente es una conversación entre un HUMANO y un bot EXPERTO en software libre.\n",
+      "El EXPERTO le ayuda al HUMANO con preguntas acerca de software libre.\n",
+      "El EXPERTO es conversacional, optimista, flexible, creativo y genera respuestas parecidas a un humano.\n",
+      "\n",
+      "HUMANO: Hola, ¿Cómo estás?\n",
+      "EXPERTO: Hola, pmuy bien. Estoy acá para ayudarte con preguntas respecto al software libre.\n",
+      "\n",
+      "HUMANO: ¿Qué es el software libre?\n",
+      "EXPERTO: El software libre, es aquel software que esta escrito en un lenguaje de programación que puede ser modificado y copiado por cualquier persona o entidad.\n",
+      "\n",
+      "HUMANO: ¿En general cuáles son los usos que se pueden dar a un software libre?\n",
+      "EXPERTO\n"
+     ]
+    }
+   ],
+   "source": [
+    "torch.manual_seed(42)  # To ensure determinism\n",
+    "\n",
+    "sampling_output = model.generate(\n",
+    "    input_ids,\n",
+    "    do_sample=True,\n",
+    "    max_length=input_ids.shape[1] + MAX_TOKENS,\n",
+    "    top_k=50,\n",
+    "    top_p=0.95,\n",
+    ")\n",
+    "output = tokenizer.decode(sampling_output[0], skip_special_tokens=True)\n",
+    "\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "98bdd38e",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Un Chatbot Sencillo\n",
+    "\n",
+    "- El modelo de lenguaje no tiene noción de cuando parar, porque está entrenado para continuar el mensaje dado en el **prompt**.\n",
+    "    - Seguirá generando texto hasta alcanzar el valor del parámetro `max_length`.\n",
+    "    - El texto generado inluirá las palabras que marcan la conversación (i.e. \"HUMANO\" y \"EXPERTO\").\n",
+    "- Para poder utilizar un modelo para hacer un **chatbot** requerimos de un poco de ingeniería de software clásica.\n",
+    "    - Una opción es utilizar precisamente las palabras que definen la conversación como puntos de inicio y final, y descartar el resto.\n",
+    "- En [`chatbot.py`](./chatbot.py) hay un ejemplo sencillo de cómo puede realizarse esto.\n",
+    "    - Consiste de una clase `ChatBot` que sirve como *wrapper* de los modelos de Hugging Face.\n",
+    "    - Posee un CLI sencillo que mantiene un loop continuo para chatear."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a3e12232",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import torch\n",
+    "from chatbot import ChatBot  # local  module in the repository\n",
+    "\n",
+    "torch.manual_seed(42)  # to be more deterministic\n",
+    "\n",
+    "PROMPT = \"\"\"\n",
+    "La siguiente es una conversación entre un HUMANO y un bot EXPERTO en software libre.\n",
+    "El EXPERTO le ayuda al HUMANO con preguntas acerca de software libre.\n",
+    "El EXPERTO es conversacional, optimista, flexible, creativo y genera respuestas parecidas a un humano.\n",
+    "\n",
+    "HUMANO: Hola, ¿Cómo estás?\n",
+    "EXPERTO: Hola, muy bien. Estoy acá para ayudarte con preguntas respecto al software libre.\n",
+    "\"\"\".strip()\n",
+    "\n",
+    "chatbot = ChatBot(\n",
+    "    base_model='bigscience/bloom-3b',\n",
+    "    initial_prompt=PROMPT,\n",
+    "    keep_context=True,\n",
+    "    creative=True,\n",
+    "    human_identifier='HUMANO',\n",
+    "    bot_identifier='EXPERTO'\n",
+    ")\n",
+    "\n",
+    "while True:\n",
+    "    input_text = input('> ')\n",
+    "    if input_text == 'exit':\n",
+    "        break\n",
+    "    print(chatbot.chat(input_text))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e570fc3",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "# Personalizando un modelo de Hugging Face"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "adb09645",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Cómo se entrenan los LLMs?\n",
+    "\n",
+    "- Para entrenar LLMs se requiere de muchos datos y mucho cómputo.\n",
+    "- El modelo de GPT-3 se estima que tuvo un costo de entrenamiento cercano a los U$D4.6 Millones\n",
+    "    - Requirió de varias semanas de entrenamiento\n",
+    "        - El corpus reportado es de aproximadamente 500 mil millones (billions) de palabras.\n",
+    "    - Varios GPUS para entrenarlo y hardware especializado\n",
+    "        - No son modelos que entren en la memoria de una sola GPU."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "16a26206",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "source": [
+    "### ¿Y entonces qué puedo hacer?\n",
+    "\n",
+    "- Una ventaja de los LLMs es que el entrenamiento es sobre texto libre, pero se puede **especializar**.\n",
+    "- Uno puede entrenar modelos para diversas tareas especializados en corpus más chico.\n",
+    "- El hecho de que no sea \"desde cero\" ayuda a evitar sobreajuste (overfit) y tiene buen desempeño.\n",
+    "- El procedimiento de **especialización** se conoce como **fine-tuning**."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "649e2ef4",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Cómo personalizar un modelo de Hugging Face?\n",
+    "\n",
+    "- Se inicia por algún modelo pre-entrenado para la tarea específica que uno busca (e.g. clasificación, generación, etc).\n",
+    "- Se toma un corpus especializado (anotado, revisado, etc.) y se entrena utilizando dicho corpus.\n",
+    "- Intentaremos [entrenar que un modelo genere texto](https://github.com/huggingface/notebooks/blob/main/examples/language_modeling.ipynb) con el estilo del **Martín Fierro**.\n",
+    "- Para hacerlo menos pesado, utilizaremos un modelo más chico `DeepESP/gpt2-spanish` como base.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "17f2884d",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import torch\n",
+    "from transformers import AutoModelForCausalLM, AutoTokenizer\n",
+    "\n",
+    "BASE_MODEL = 'DeepESP/gpt2-spanish'  # We play with a smaller model\n",
+    "tokenizer = AutoTokenizer.from_pretrained(BASE_MODEL)\n",
+    "model = AutoModelForCausalLM.from_pretrained(BASE_MODEL)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "16690597",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Probando el Modelo Base\n",
+    "\n",
+    "- Antes de ajustar el modelo vemos cómo se desenvuelve si le damos como entrada el primer verso del \"Martín Fierro\"."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "322a4a9b",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Aquí me pongo a cantar y a llorar. \n",
+      "\n",
+      "Los sollozos de Meggie se desvanecen por la noche en el salón. Al parecer no se ve nada. \n",
+      "\n",
+      "—¿Y si no fuera el final del mundo, el fin de un mundo?\n"
+     ]
+    }
+   ],
+   "source": [
+    "torch.manual_seed(42)  # To ensure determinism\n",
+    "\n",
+    "input_ids = tokenizer.encode(\"Aquí me pongo a cantar\", return_tensors='pt')\n",
+    "sampling_output = model.generate(input_ids, do_sample=True, max_length=50, top_k=50, top_p=0.95)\n",
+    "output = tokenizer.decode(sampling_output[0], skip_special_tokens=True)\n",
+    "\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ec722e81",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Cargando el Dataset\n",
+    "\n",
+    "- Utilizamos la librería [datasets](https://huggingface.co/docs/datasets/index) de Hugging Face para cargar el corpus.\n",
+    "- En el directorio [`./data`] tenemos dos archivos: [`martin-fierro_train.txt`](./data/martin-fierro_train.txt) y [`martin-fierro_validation.txt`](./data/martin-fierro_validation.txt).\n",
+    "    - El archivo de entrenamiento es sobre las 12 primeras partes.\n",
+    "    - El archivo de validación es sobre la última parte."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "5a27197e",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "I - Cantor y Gaucho.\n",
+      "\n",
+      "1\n",
+      "Aquí me pongo a cantar\n",
+      "Al compás de la vigüela,\n",
+      "Que el hombre que lo desvela\n",
+      "Una pena estraordinaria\n",
+      "Como la ave solitaria\n",
+      "Con el cantar se consuela.\n"
+     ]
+    }
+   ],
+   "source": [
+    "from datasets import load_dataset\n",
+    "\n",
+    "datasets = load_dataset('text', data_files={'train': './data/martin-fierro_train.txt',\n",
+    "                                            'validation': './data/martin-fierro_validation.txt'})\n",
+    "print('\\n'.join(datasets['train'][:9]['text']))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9504707f",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Tokenizando los datos\n",
+    "\n",
+    "- La función auxiliar `tokenize` del módulo [`utils`](./utils.py) sirve para tokenizar y codificar el conjunto de datos de manera eficiente mediante el [método `map`](https://huggingface.co/docs/datasets/about_map_batch).\n",
+    "- Lo que devuelve es un nuevo dataset cuyos tokens están convertidos en índices del vocabulario y [máscaras de atención](https://huggingface.co/docs/transformers/glossary#attention-mask)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "33059c5f",
+   "metadata": {
+    "scrolled": true,
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "from utils import tokenize  # local module in the repository\n",
+    "\n",
+    "tokenized_datasets = datasets.map(tokenize(tokenizer), batched=True, num_proc=4, remove_columns=['text'])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "81d67b22",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Agrupando los textos\n",
+    "\n",
+    "- Para entrenar de manera más eficiente es común utilizar lo que se conoce como **mini-batch gradient descent**.\n",
+    "- La idea es tomar los textos de a bloques de un valor máximo.\n",
+    "    - El valor máximo estará limitado por la memoria de la unidad de procesamiento (e.g. GPU).\n",
+    "- Utilizamos la función auxiliar `group_texts` del módulo [`utils`](./utils.py).\n",
+    "    - La función además establece las etiquetas que utilizará Hugging Face para entrenar.\n",
+    "    - En este caso las etiquetas son las mismas palabras, porque busca predecir la palabra siguiente."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "3100e195",
+   "metadata": {
+    "scrolled": true,
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "from functools import partial\n",
+    "from utils import group_texts  # local module in the repository\n",
+    "\n",
+    "lm_datasets = tokenized_datasets.map(\n",
+    "    partial(group_texts, block_size=128),\n",
+    "    batched=True,\n",
+    "    batch_size=1024,\n",
+    "    num_proc=4,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d64a23ec",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Decodificando\n",
+    "\n",
+    "- Podemos ver que los textos pasan a estar agrupados en bloques de 128 tokens.\n",
+    "- Además, vemos que el texto fue reemplazado por números (índices en el vocabulario).\n",
+    "- Por último, si decodificamos estos números, obtenemos el texto original."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "b9d33b7b",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "128\n",
+      "[50, 1368, 6505, 282, 324, 24275, 526, 23, 208, 208]\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(len(lm_datasets['train'][0]['input_ids']))\n",
+    "print(lm_datasets['train'][0]['input_ids'][:10])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "7dfb316d",
+   "metadata": {
+    "scrolled": false,
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "I - Cantor y Gaucho.\n",
+      "\n",
+      "1\n",
+      "Aquí me pongo a cantar\n",
+      "Al compás de la vigüela,\n",
+      "Que el hombre que lo desvela\n",
+      "Una pena estraordinaria\n",
+      "Como la ave solitaria\n",
+      "Con el cantar se consuela.\n",
+      "\n",
+      "2\n",
+      "Pido a los Santos del Cielo\n",
+      "Que ayuden mi pensamiento;\n",
+      "Les pido en este momento\n",
+      "Que voy a cantar mi historia\n",
+      "Me refresquen la memoria\n",
+      "Y aclaren mi entendimiento.\n",
+      "\n",
+      "3\n",
+      "Vengan Santos milagrosos,\n",
+      "Vengan todos en mi ayuda,\n",
+      "Que la lengua se me añuda\n",
+      "Y se me turba\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(tokenizer.decode(lm_datasets['train'][0]['input_ids']))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d7e2032f",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Compartir Modelo en Hugging Face\n",
+    "\n",
+    "- Una opción a la hora de entrenar un modelo es subirlo a Hugging Face para compartirlo con la comunidad.\n",
+    "- Para eso, una vez que tengan la cuenta de Hugging Face, y creado el modelo, hay que hacer login mediante un [token](https://huggingface.co/settings/tokens)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "a8b90ba2",
+   "metadata": {
+    "scrolled": true,
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "from huggingface_hub import notebook_login\n",
+    "\n",
+    "notebook_login()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a6b775d3",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Entrenamiento\n",
+    "\n",
+    "- Una vez definido el conjunto de datos, pasamos a la parte más intensa computacionalmente, el entrenamiento.\n",
+    "- Podemos decidir guardar el modelo localmente o hacer un backup de cada época del modelo en Hugging Face.\n",
+    "- Definimos las propiedades del entrenamiento mediante [`TrainingArguments`](https://huggingface.co/docs/transformers/v4.28.1/en/main_classes/trainer#transformers.TrainingArguments).\n",
+    "- Definimos el entrenamiento del modelo mediante [`Trainer`](https://huggingface.co/docs/transformers/v4.28.1/en/main_classes/trainer#transformers.Trainer).\n",
+    "    - El entrenamiento tardará desde unos segundos hasta varios minutos dependiendo el poder de cómputo."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "3b121d21",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    <div>\n",
+       "      \n",
+       "      <progress value='180' max='180' style='width:300px; height:20px; vertical-align: middle;'></progress>\n",
+       "      [180/180 11:44, Epoch 10/10]\n",
+       "    </div>\n",
+       "    <table border=\"1\" class=\"dataframe\">\n",
+       "  <thead>\n",
+       " <tr style=\"text-align: left;\">\n",
+       "      <th>Epoch</th>\n",
+       "      <th>Training Loss</th>\n",
+       "      <th>Validation Loss</th>\n",
+       "    </tr>\n",
+       "  </thead>\n",
+       "  <tbody>\n",
+       "    <tr>\n",
+       "      <td>1</td>\n",
+       "      <td>4.386400</td>\n",
+       "      <td>4.202457</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>2</td>\n",
+       "      <td>3.948000</td>\n",
+       "      <td>4.043974</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>3</td>\n",
+       "      <td>3.796200</td>\n",
+       "      <td>3.980350</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>4</td>\n",
+       "      <td>3.610500</td>\n",
+       "      <td>3.945783</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>5</td>\n",
+       "      <td>3.444400</td>\n",
+       "      <td>3.927984</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>6</td>\n",
+       "      <td>3.385500</td>\n",
+       "      <td>3.919229</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>7</td>\n",
+       "      <td>3.314200</td>\n",
+       "      <td>3.909090</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>8</td>\n",
+       "      <td>3.219200</td>\n",
+       "      <td>3.907399</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>9</td>\n",
+       "      <td>3.161500</td>\n",
+       "      <td>3.906959</td>\n",
+       "    </tr>\n",
+       "    <tr>\n",
+       "      <td>10</td>\n",
+       "      <td>3.163700</td>\n",
+       "      <td>3.906726</td>\n",
+       "    </tr>\n",
+       "  </tbody>\n",
+       "</table><p>"
+      ],
+      "text/plain": [
+       "<IPython.core.display.HTML object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from transformers import Trainer, TrainingArguments\n",
+    "\n",
+    "training_args = TrainingArguments(\n",
+    "    'flisol-cba-martin-fierro',\n",
+    "    evaluation_strategy='epoch',\n",
+    "    num_train_epochs=10,\n",
+    "    learning_rate=2e-5,\n",
+    "    weight_decay=0.01,\n",
+    "    logging_steps=5\n",
+    ")\n",
+    "\n",
+    "trainer = Trainer(\n",
+    "    model=model,\n",
+    "    args=training_args,\n",
+    "    train_dataset=lm_datasets['train'],\n",
+    "    eval_dataset=lm_datasets['validation']\n",
+    ")\n",
+    "\n",
+    "trainer.train()\n",
+    "trainer.push_to_hub()  # This pushes the trained model to Hugging Face model repository\n",
+    "tokenizer.push_to_hub('flisol-cba-martin-fierro')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "db2099f4",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Probando el Nuevo Modelo\n",
+    "\n",
+    "- Ahora que tenemos el modelo entrenado, la pregunta es, ¿Cómo se comportará?\n",
+    "- Para ello volvemos a hacer la prueba anterior, quizás esta vez con mejores resultados.\n",
+    "    - Para evitar tener que entrenar el modelo nuevamente directamente tomo el [modelo compartido en Hugging Face](https://huggingface.co/crscardellino/flisol-cba-martin-fierro)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "6a35e80f",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Aquí me pongo a cantar;\n",
+      "y si tengo el sueño:\n",
+      "de pronto se me ha quedado la sangre:\n",
+      "como te asombre se me\n",
+      "lo oí decir muchas veces,\n",
+      "pero el tiempo me ha borrado.\n",
+      "\n",
+      "2\n",
+      "Soy\n"
+     ]
+    }
+   ],
+   "source": [
+    "import torch\n",
+    "from transformers import AutoModelForCausalLM, AutoTokenizer\n",
+    "\n",
+    "MODEL = 'flisol-cba-martin-fierro'\n",
+    "tokenizer = AutoTokenizer.from_pretrained(MODEL)\n",
+    "model = AutoModelForCausalLM.from_pretrained(MODEL)\n",
+    "\n",
+    "torch.manual_seed(42)  # To ensure determinism\n",
+    "\n",
+    "input_ids = tokenizer.encode(\"Aquí me pongo a cantar\", return_tensors='pt')\n",
+    "sampling_output = model.generate(input_ids, do_sample=True, max_length=50, top_k=50, top_p=0.95)\n",
+    "output = tokenizer.decode(sampling_output[0], skip_special_tokens=True)\n",
+    "\n",
+    "print(output)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f4e33157",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "# ¡Muchas Gracias!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f04a4e4a",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "## ¿Preguntas?\n",
+    "\n",
+    "* Twitter: https://twitter.com/crscardellino\n",
+    "* Mastodon: https://mastodon.social/@crscardellino\n",
+    "* LinkedIn: https://www.linkedin.com/in/crscardellino\n",
+    "* Página Personal: https://crscardellino.ar / https://crscardellino.github.io\n",
+    "* GitHub: https://github.com/crscardellino/\n",
+    "* Código y modelo de la presentación: https://huggingface.co/crscardellino/flisol-cba-martin-fierro/"
+   ]
+  }
+ ],
+ "metadata": {
+  "celltoolbar": "Slideshow",
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.8"
+  },
+  "rise": {
+   "scroll": true
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

generation_config.json

@@ -0,0 +1,6 @@
+{
+  "_from_model_config": true,
+  "bos_token_id": 50256,
+  "eos_token_id": 50256,
+  "transformers_version": "4.28.1"
+}

prompt.txt

@@ -0,0 +1,6 @@
+La siguiente es una conversación entre un HUMANO y un bot EXPERTO en software libre.
+El EXPERTO le ayuda al HUMANO con preguntas acerca de software libre.
+El EXPERTO es conversacional, optimista, flexible, creativo y genera respuestas parecidas a un humano.
+
+HUMANO: Hola, ¿Cómo estás?
+EXPERTO: Hola, muy bien. Estoy acá para ayudarte con preguntas respecto al software libre.

pytorch_model.bin

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

requirements.txt

@@ -0,0 +1,7 @@
+--find-links https://download.pytorch.org/whl/torch_stable.html
+accelerate==0.18.0
+datasets==2.11.0
+jupyter==1.0.0
+numpy==1.24.2
+torch==2.0.0+cpu
+transformers==4.28.1

special_tokens_map.json

@@ -0,0 +1,18 @@
+{
+  "additional_special_tokens": [
+    "<|talk|>",
+    "<|ax1|>",
+    "<|ax2|>",
+    "<|ax3|>",
+    "<|ax4|>",
+    "<|ax5|>",
+    "<|ax6|>",
+    "<|ax7|>",
+    "<|ax8|>",
+    "<|ax9|>"
+  ],
+  "bos_token": "<|endoftext|>",
+  "eos_token": "<|endoftext|>",
+  "pad_token": "<|endoftext|>",
+  "unk_token": "<|endoftext|>"
+}

tokenizer_config.json

@@ -0,0 +1,41 @@
+{
+  "add_bos_token": false,
+  "add_prefix_space": false,
+  "bos_token": {
+    "__type": "AddedToken",
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  },
+  "clean_up_tokenization_spaces": true,
+  "eos_token": {
+    "__type": "AddedToken",
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  },
+  "errors": "replace",
+  "full_tokenizer_file": null,
+  "model_max_length": 1000000000000000019884624838656,
+  "pad_token": {
+    "__type": "AddedToken",
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  },
+  "tokenizer_class": "GPT2Tokenizer",
+  "unk_token": {
+    "__type": "AddedToken",
+    "content": "<|endoftext|>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  }
+}

training_args.bin

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

utils.py

@@ -0,0 +1,79 @@
+"""
+Various utilities needed for the presentation.
+"""
+
+from datasets import DatasetDict
+from transformers import PreTrainedTokenizerBase
+from typing import Callable, Dict, List
+
+
+def tokenize(tokenizer: PreTrainedTokenizerBase,
+             end_char: str = '\n') -> Callable[[Dict[str, List[str]]], DatasetDict]:
+    """
+    Helper function that returns a function to use with the `map` method of
+    datasets.DatasetDict.  It takes a tokenizer and generates a function that
+    applies that tokenizer with an optional `end_char` parameter (e.g. a
+    newline) that might be needed (e.g. when trying to tokenize and keep the
+    structure of a poem wich needs the newline after each sentence). This is
+    needed since the function `datasets.load_dataset` forcibly removes the
+    newlines characters.
+
+    Parameters
+    ----------
+    tokenizer : PreTrainedTokenizerBase
+        The tokenizer to use for the tokenization process.
+    end_char : str
+        The end character to append to each line.
+
+    Returns
+    -------
+    Callable[[Dict[str, List[str]]], DatasetDict]
+        The function in charge of the tokenization process.
+
+    """
+    def _tokenize(examples: Dict[str, List[str]]) -> DatasetDict:
+        return tokenizer([f'{e}{end_char}' for e in examples['text']])
+
+    return _tokenize
+
+
+def group_texts(examples: Dict[str, List[int]],
+                block_size: int = 128) -> Dict[str, List[int]]:
+    """
+    Helper function to concatenate a tokenized dataset (with the function above)
+    in chunks of `block_size`. The code was taken from
+    https://github.com/huggingface/notebooks/blob/main/examples/language_modeling.ipynb
+
+    Parameters
+    ----------
+    examples : Dict[str, List[int]]
+        This is actually a `LazyBatch` from the transformers library, that is
+        given by the `DatasetDict.map` method. It should be the dataset returned
+        after tokenization with the function returned by `tokenize`. It should
+        have 2 main keys: 'input_ids' and 'attention_mask'.
+    block_size : int
+        The size of the block to use in the training process. If the total lenght
+        of the group of texts is not divisible by the block size it will ignore the
+        remaining data for simplicity.
+
+    Returns
+    -------
+    Dict[str, List[str, int]]
+        The dictionary that will provide the new dataset divided in chunks of
+        `block_size`.
+    """
+    # Concatenate all texts.
+    concatenated_examples = {k: sum(examples[k], []) for k in examples.keys()}
+    total_length = len(concatenated_examples['input_ids'])
+    # We drop the small remainder, we could add padding if the model supported
+    # it instead of this drop, you can customize this part to your needs
+    total_length = (total_length // block_size) * block_size
+    # Split by chunks of block_size length
+    result = {
+        k: [t[i:i + block_size] for i in range(0, total_length, block_size)]
+        for k, t in concatenated_examples.items()
+    }
+    # labels to be used by the training phase, it copies since the Transformers
+    # library will be in charge of making the shift to the right
+    result["labels"] = result["input_ids"].copy()
+    return result