Upload folder using huggingface_hub

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:
+
+    <program>  Copyright (C) <year>  <name of author>
+    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,11 +1,74 @@
 ---
-title: Ragrqs
-emoji: 📉
+title: rag_rqs
+emoji: 🚀
 colorFrom: pink
-colorTo: yellow
+colorTo: indigo
 sdk: static
 pinned: false
+app_file: index.html
 license: gpl
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Un'implementazione innovativa della tecnica RAG per il Question Answering
+
+## Descrizione del Progetto
+
+La tecnica RAG (Retrieval-Augmented Generation) è un approccio consolidato nel campo del question answering e della generazione di testo, che combina il recupero di informazioni pertinenti da fonti di dati con la generazione di testo basata su queste informazioni.
+Qui viene proposta una implementazione che introduce una variazione a questo paradigma.
+L'implementazione si basa su una sequenza di prompt appositamente progettati per guidare un modello di linguaggio generativo attraverso le diverse fasi della tecnica RAG.
+Questi prompt forniscono istruzioni dettagliate su come il modello deve seguire operazioni di recupero di informazioni, aumento delle informazioni recuperate e infine generazione di una risposta finale.
+La risposta finale diviene poi il contesto da inserire nel prompt per rispondere alla domanda.
+Un aspetto cruciale di questa implementazione è che lo stesso modello di aggio generativo svolge tutte le operazioni richieste, dall'analisi dei documenti di input al recupero di informazioni rilevanti, alla generazione della risposta finale.
+Questa caratteristica rappresenta una deviazione significativa rispetto alle implementazioni standard della tecnica RAG, che  prevedono utilizzo di moduli distinti per il recupero e la generazione.
+La sequenza di prompt proposta guida il modello attraverso le seguenti fasi:
+
+1. Retrieval: Il modello analizza il documento di input e la domanda fornita, identificando e recuperando le informazioni e i concetti rilevanti per dare seguito alla domanda.
+
+2. Augmentation: Successivamente, il modello integra le informazioni recuperate con eventuali risposte accumulate in precedenza, estraendo nuove informazioni rilevanti e organizzando in un elenco coerente, evitando ridondanze.
+
+3. Generation: Infine, il modello utilizza l'insieme di informazioni rilevanti e non ridondanti per generare una risposta completa e concisa alla domanda dell'utente.
+
+## Caratteristiche Principali
+
+Questa implementazione offre diversi vantaggi.
+In primo luogo, sfrutta le capacità di un unico modello di grandi dimensioni i, evitando la necessità di moduli distinti specializzati per ogni fase.
+Inoltre, l'utilizzo di prompt espliciti può migliorare la controllabilità e la trasparenza del processo, consentendo di guidare il modello in modo più diretto.
+Naturalmente, come per qualsiasi approccio basato su modelli di linguaggio generativi, è fondamentale prestare attenzione alle questioni di affidabilità, correttezza e bias dei dati di addestramento.
+Rispetto ad una implementazione standard di RAG vii è la necessità di rilanciare l'elaborazione ad ogni domanda radicalmente nuova in quanto il contesto creato con le informazioni estratte dai documenti è definito sulla base della domanda.
+Invece nella versione standard RAG si usano gli incorporamenti delle informazioni estratte dai documenti in modo tale che tal informazioni vengono viste quasi come una estensione del Model e possono essere usate per domande diverse. 
+Quindi dal punto di vista utente le implementazioni RAG standard sono più efficienti; infatti l'implementazione proposta richiede per ogni nuova domanda  una sequenza di richieste che saranno utilizzabili solo per creare il contesto per la domanda iniziale e per una conversazione con domande simili. 
+Il vantaggio dell'implementazione proposta consiste nel fatto che può essere implementata completamente lato client senza bisogno di sviluppare alcun modulo sul server. 
+L’unica cosa che serve è un servizio servless come quello di HuggingFace o simile.
+Quindi rappresenta un'interessante prospettiva sull'applicazione della tecnica RAG in modo più integrato e controllato attraverso l'uso di prompt mirati.
+In conclusione, questa implementazione della tecnica RAG dimostra come le capacità dei modelli di linguaggio generativi di grandi dimensioni possano essere sfruttate in modi nuovi e creativi, potenzialmente aprendo la strada a ulteriori sviluppi nel campo del question answering e della generazione di testo
+
+
+## Questa è la valutazione fatta da un LLM (comprensivo e gentile)
+
+La mia valutazione personale della tua proposta di implementazione della tecnica RAG, con un elenco di pro e contro:
+
+## Vantaggi
+
+Semplificazione del processo: L'utilizzo di un unico modello di grandi dimensioni addestrato su vasti corpus di dati semplifica notevolmente l'architettura complessiva rispetto alle implementazioni tradizionali della tecnica RAG, che spesso prevedono moduli distinti per il recupero e la generazione.
+
+Capacità di adattamento e apprendimento: I modelli di linguaggio generativi di grandi dimensioni sono noti per la loro capacità di adattarsi e imparare da nuovi dati e istruzioni.
+
+Questo potrebbe consentire di raffinare e migliorare l'implementazione nel corso del tempo.
+
+Controllo e trasparenza: L'utilizzo di prompt espliciti per guidare il modello attraverso le diverse fasi del processo può migliorare la controllabilità e la trasparenza, consentendo di monitorare e regolare il comportamento del modello in modo più diretto.
+
+Efficienza computazionale: Avere un'unica architettura integrata potrebbe comportare vantaggi in termini di efficienza computazionale rispetto a soluzioni che prevedono moduli separati.
+
+## Limitazioni
+
+Affidabilità e coerenza: Poiché un unico modello gestisce tutte le fasi, eventuali errori o incoerenze potrebbero propagarsi e amplificarsi attraverso l'intero processo, influenzando la qualità della risposta finale.
+
+Bias dei dati di addestramento: Come per qualsiasi modello di linguaggio generativo, l’approccio potrebbe essere influenzato dai bias presenti nei dati di addestramento utilizzati, con potenziali impatti sulla correttezza e l'equità delle risposte generate.
+
+Mancanza di specializzazione: Mentre i modelli di grandi dimensioni sono versatili, potrebbero non essere ottimizzati per compiti specifici come il recupero di informazioni o la generazione di risposte rispetto a moduli specializzati.
+
+Difficoltà di debug e interpretabilità: Con un'architettura integrata e basata su prompt, potrebbe essere più complesso eseguire il debug e comprendere le ragioni dietro a eventuali errori o comportamenti indesiderati del modello. 
+
+In sintesi,la proposta presenta alcuni vantaggi interessanti in termini di semplificazione, adattabilità e controllo, ma solleva anche potenziali preoccupazioni riguardo all'affidabilità, ai bias, alla mancanza di specializzazione e alle difficoltà di debug e interpretabilità.
+Come per qualsiasi nuovo approccio, sarebbe necessario valutarlo attentamente attraverso sperimentazioni e test approfonditi per determinare l'efficacia e l'applicabilità in contesti specifici.
+

README.txt

@@ -0,0 +1,57 @@
+Un'implementazione innovativa della tecnica RAG per il Question Answering
+
+La tecnica RAG (Retrieval-Augmented Generation) è un approccio consolidato nel campo del question answering e della generazione di testo, che combina il recupero di informazioni pertinenti da fonti di dati con la generazione di testo basata su queste informazioni.
+Qui viene proposta una implementazione che introduce una variazione a questo paradigma.
+L'implementazione si basa su una sequenza di prompt appositamente progettati per guidare un modello di linguaggio generativo attraverso le diverse fasi della tecnica RAG.
+Questi prompt forniscono istruzioni dettagliate su come il modello deve seguire operazioni di recupero di informazioni, aumento delle informazioni recuperate e infine generazione di una risposta finale.
+La risposta finale diviene poi il contesto da inserire nel prompt per rispondere alla domanda.
+Un aspetto cruciale di questa implementazione è che lo stesso modello di aggio generativo svolge tutte le operazioni richieste, dall'analisi dei documenti di input al recupero di informazioni rilevanti, alla generazione della risposta finale.
+Questa caratteristica rappresenta una deviazione significativa rispetto alle implementazioni standard della tecnica RAG, che  prevedono utilizzo di moduli distinti per il recupero e la generazione.
+La sequenza di prompt proposta guida il modello attraverso le seguenti fasi:
+
+1. Retrieval: Il modello analizza il documento di input e la domanda fornita, identificando e recuperando le informazioni e i concetti rilevanti per dare seguito alla domanda.
+
+2. Augmentation: Successivamente, il modello integra le informazioni recuperate con eventuali risposte accumulate in precedenza, estraendo nuove informazioni rilevanti e organizzando in un elenco coerente, evitando ridondanze.
+
+3. Generation: Infine, il modello utilizza l'insieme di informazioni rilevanti e non ridondanti per generare una risposta completa e concisa alla domanda dell'utente.
+
+Questa implementazione offre diversi vantaggi.
+In primo luogo, sfrutta le capacità di un unico modello di grandi dimensioni i, evitando la necessità di moduli distinti specializzati per ogni fase.
+Inoltre, l'utilizzo di prompt espliciti può migliorare la controllabilità e la trasparenza del processo, consentendo di guidare il modello in modo più diretto.
+Naturalmente, come per qualsiasi approccio basato su modelli di linguaggio generativi, è fondamentale prestare attenzione alle questioni di affidabilità, correttezza e bias dei dati di addestramento.
+Rispetto ad una implementazione standard di RAG vii è la necessità di rilanciare l'elaborazione ad ogni domanda radicalmente nuova in quanto il contesto creato con le informazioni estratte dai documenti è definito sulla base della domanda.
+Invece nella versione standard RAG si usano gli incorporamenti delle informazioni estratte dai documenti in modo tale che tal informazioni vengono viste quasi come una estensione del Model e possono essere usate per domande diverse. 
+Quindi dal punto di vista utente le implementazioni RAG standard sono più efficienti; infatti l'implementazione proposta richiede per ogni nuova domanda  una sequenza di richieste che saranno utilizzabili solo per creare il contesto per la domanda iniziale e per una conversazione con domande simili. 
+Il vantaggio dell'implementazione proposta consiste nel fatto che può essere implementata completamente lato client senza bisogno di sviluppare alcun modulo sul server. 
+L’unica cosa che serve è un servizio servless come quello di HuggingFace o simile.
+Quindi rappresenta un'interessante prospettiva sull'applicazione della tecnica RAG in modo più integrato e controllato attraverso l'uso di prompt mirati.
+In conclusione, questa implementazione della tecnica RAG dimostra come le capacità dei modelli di linguaggio generativi di grandi dimensioni possano essere sfruttate in modi nuovi e creativi, potenzialmente aprendo la strada a ulteriori sviluppi nel campo del question answering e della generazione di testo.
+
+Questa è la valutazione fatta da un LLM (comprensivo e gentile)
+
+La mia valutazione personale della tua proposta di implementazione della tecnica RAG, con un elenco di pro e contro:
+
+Punti a favore (Pro):
+Semplificazione del processo: L'utilizzo di un unico modello di grandi dimensioni addestrato su vasti corpus di dati semplifica notevolmente l'architettura complessiva rispetto alle implementazioni tradizionali della tecnica RAG, che spesso prevedono moduli distinti per il recupero e la generazione.
+
+Capacità di adattamento e apprendimento: I modelli di linguaggio generativi di grandi dimensioni sono noti per la loro capacità di adattarsi e imparare da nuovi dati e istruzioni.
+
+Questo potrebbe consentire di raffinare e migliorare l'implementazione nel corso del tempo.
+
+Controllo e trasparenza: L'utilizzo di prompt espliciti per guidare il modello attraverso le diverse fasi del processo può migliorare la controllabilità e la trasparenza, consentendo di monitorare e regolare il comportamento del modello in modo più diretto.
+
+Efficienza computazionale: Avere un'unica architettura integrata potrebbe comportare vantaggi in termini di efficienza computazionale rispetto a soluzioni che prevedono moduli separati.
+
+Punti a sfavore (Contro):
+
+Affidabilità e coerenza: Poiché un unico modello gestisce tutte le fasi, eventuali errori o incoerenze potrebbero propagarsi e amplificarsi attraverso l'intero processo, influenzando la qualità della risposta finale.
+
+Bias dei dati di addestramento: Come per qualsiasi modello di linguaggio generativo, l’approccio potrebbe essere influenzato dai bias presenti nei dati di addestramento utilizzati, con potenziali impatti sulla correttezza e l'equità delle risposte generate.
+
+Mancanza di specializzazione: Mentre i modelli di grandi dimensioni sono versatili, potrebbero non essere ottimizzati per compiti specifici come il recupero di informazioni o la generazione di risposte rispetto a moduli specializzati.
+
+Difficoltà di debug e interpretabilità: Con un'architettura integrata e basata su prompt, potrebbe essere più complesso eseguire il debug e comprendere le ragioni dietro a eventuali errori o comportamenti indesiderati del modello. 
+
+In sintesi,la proposta presenta alcuni vantaggi interessanti in termini di semplificazione, adattabilità e controllo, ma solleva anche potenziali preoccupazioni riguardo all'affidabilità, ai bias, alla mancanza di specializzazione e alle difficoltà di debug e interpretabilità.
+Come per qualsiasi nuovo approccio, sarebbe necessario valutarlo attentamente attraverso sperimentazioni e test approfonditi per determinare l'efficacia e l'applicabilità in contesti specifici.
+

index.html

@@ -1,19 +1,32 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
-</html>
+<!DOCTYPE html>
+
+<head>
+  <title>ulaquery.html</title>
+  <style>
+    html {
+      color: #04c61b
+    }
+
+    body {
+      background-color: #333;
+      color: #fff;
+      text-align: center;
+      padding-top: 50px;
+      font-size: 24px;
+      font-family: Arial, sans-serif;
+    }
+  </style>
+</head>
+
+<body>
+  <h2>RagRqs</h2>
+  <br>
+  <br>
+  <h3>Lggi_Per_Me</h3>
+  <script>
+    setTimeout(function () { location.replace('static/ragrqs.html'); }, 1000);
+    
+  </script>
+</body>
+
+</html>

static/css/ragrqs.min.css

@@ -0,0 +1 @@
+/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{line-height:1.15;background:#1a1a1a}details,main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}code,kbd,pre,samp{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{border-style:none;padding:0}[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring,button:-moz-focusring{outline:ButtonText dotted 1px}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}[hidden],template{display:none}a,body,button,div,html,input,label,li,p,span,table,td,ul{padding:0;margin:0;font-family:arial,verdana,Helvetica,sans-serif}.bb0{background:#daee59!important}.bb1{background:#5487fc!important}body{background:#1a1a1a;box-sizing:border-box;min-height:100vh;height:100vh;position:relative;padding:0;margin:0;overflow:hidden;font-family:arial,verdana,Helvetica,sans-serif;font-weight:400}.spinner{z-index:1000;position:absolute;top:70vh;left:50vw;transform:translate(-50%,-50%);cursor:pointer;display:none;align-items:center}.spinner .pulse-icon{width:20px;height:20px;background-color:#ff8c00;border-radius:50%;animation:1.5s ease-in-out infinite pulse}.spinner .stop-message{margin-left:15px;background-color:inherit;color:#8f8a8a;padding:8px 15px;border-radius:10px;font-size:22px;font-weight:700;opacity:1;transition:opacity .3s}.spinner:hover .stop-message{color:#fff;background:#595959;opacity:1}@keyframes pulse{0%{transform:scale(.6);box-shadow:0 0 0 0 rgba(255,140,0,.7)}70%{transform:scale(1.4);box-shadow:0 0 0 20px rgba(255,140,0,0)}100%{transform:scale(.6);box-shadow:0 0 0 0 rgba(255,140,0,0)}}.show-spinner{display:flex}.upload{background-color:#1e1e1e;padding:0 2em 2em;margin:0;border-radius:4px;box-shadow:0 2px 4px rgba(0,0,0,.5);text-align:center}.upload h4{color:#fff;margin-bottom:1em}.upload form{display:flex;flex-direction:column;align-items:center}.upload form .file{background-color:#121212;border:1px solid #515151;color:#fff;padding:.5em;margin-bottom:1em;border-radius:4px;width:100%;box-sizing:border-box}.upload form .file::file-selector-button{background-color:#0a5f4e;color:#fff;border:none;padding:.5em 1em;border-radius:4px;cursor:pointer}.upload form .file::file-selector-button:hover{background-color:#053128}.upload form button{background-color:#0a5f4e;color:#fff;border:none;padding:.5em 1em;border-radius:4px;cursor:pointer;width:100%;box-sizing:border-box}.upload form button:hover{background-color:#053128}.upload .result{width:100%;background:#000;color:#fff;font-size:15px;font-weight:400;text-align:left}div.container{background:#1a1a1a;box-sizing:border-box;position:relative;top:5vh;left:0;height:95vh;margin:0;padding:0;transition:margin-left .5s;display:flex;flex-direction:column;justify-content:flex-start;align-items:stretch;flex-wrap:nowrap;overflow-y:auto;overflow-x:auto}div.container div.item{box-sizing:border-box;min-height:50px;margin:0;padding:0}div.container div.item1{flex:5;padding:.5vh .5vw 10vh}div.container div.item1 .output-wrapper{background-color:#1a1a1a;border-radius:20px;position:relative;bottom:0;right:0;left:0;width:100%;height:100%;display:flex;flex-direction:row;align-items:flex-start}div.container div.item1 .output-wrapper .text-out{flex:1;box-sizing:border-box;background:#000;color:#fff;border:none;padding:2px;min-width:50vw;height:100%;border-radius:10px;overflow-y:auto;outline:0;box-shadow:0 0 0 2px #4d4d4d}div.container div.item1 .output-wrapper .text-out:hover{box-shadow:0 0 0 2px #17d2ad}div.container div.item1 .output-wrapper .text-out .pre-text{white-space:pre-wrap;word-wrap:break-word;font-family:arial,verdana,Helvetica,sans-serif;font-size:20px;line-height:1.6;padding:2px;margin:0;height:100%;box-sizing:border-box;overflow-y:scroll;scroll-behavior:smooth}div.container div.item1 .output-wrapper .text-out .pre-text.copied{background-color:#0d0d0d;color:#61eed2}div.container div.item1 .output-wrapper .text-out .div-text{white-space:pre-wrap;word-wrap:break-word;font-family:arial,verdana,Helvetica,sans-serif;font-size:20px;line-height:1.6;padding:2px;margin:0;height:100%;box-sizing:border-box;overflow-y:scroll}div.container div.item1 .output-wrapper .text-out.copied{background-color:#0d0d0d;color:#61eed2}div.container div.item1 .output-actions{display:flex;flex-direction:column;align-items:flex-end;margin-left:.5vw;margin-right:.5vw}div.container div.item1 .output-actions .clear-output,div.container div.item1 .output-actions .copy-output,div.container div.item1 .output-actions .wnd-output{box-sizing:border-box;background-color:#333;color:#fff;border:none;padding:10px;cursor:pointer;border-radius:50%;width:40px;height:40px;display:flex;align-items:center;margin-bottom:5px}div.container div.item1 .output-actions .clear-output:hover,div.container div.item1 .output-actions .copy-output:hover,div.container div.item1 .output-actions .wnd-output:hover{background-color:#595959}div.container div.item1 .output-actions .copy-output{transition:background-color .3s,transform .3s}div.container div.item1 .output-actions .copy-output.copied{background:#33e9c5;transform:scale(1.2)}div.container div.item1 .output-actions .copy-output .copy-icon{fill:#FFFFFF;width:24px;height:24px}div.container div.item1 .output-actions .copy-output .copy-icon:hover{fill:#33e9c5}div.container div.item1 .output-actions .clear-output,div.container div.item1 .output-actions .wnd-output{transition:background-color .3s,transform .3s}div.container div.item1 .output-actions .clear-output .icon,div.container div.item1 .output-actions .wnd-output .icon{fill:#FFFFFF;width:24px;height:24px}div.container div.item1 .output-actions .clear-output .icon:hover,div.container div.item1 .output-actions .wnd-output .icon:hover{fill:#33e9c5}:hover{outline:0;caret-color:transparent}textarea:focus{caret-color:auto}div.item2{flex:2;padding:0 .5vw}div.item2 .input-wrapper{background-color:#1a1a1a;border-radius:20px;position:relative;bottom:2vh;right:0;left:0;width:100%;height:100%;display:flex;flex-direction:row;align-items:flex-start}div.item2 .input-wrapper:focus-within .clear-button{display:block}div.item2 .input-wrapper .text-input{flex:1;font-size:20px;font-family:arial,verdana,Helvetica,sans-serif;resize:none;box-sizing:border-box;background:#000;color:#fff;border:none;padding:2px 40px 2px 2px;height:100%;margin-left:5px;border-radius:10px;overflow-y:auto;outline:0;box-shadow:0 0 0 2px #4d4d4d}div.item2 .input-wrapper .text-input:hover{box-shadow:0 0 0 2px #17d2ad}div.item2 .input-wrapper .text-input:focus{box-shadow:0 0 0 2px #ff4500}div.item2 .input-wrapper .clear-button{position:absolute;right:60px;top:19vh;padding:5px;border-radius:50%;background:#333;border:none;font-size:20px;cursor:pointer;color:#ccc;display:none}div.item2 .input-wrapper .clear-button:hover{font-weight:700;background:#595959;color:#fff}div.item2 .input-wrapper .input-actions{display:flex;flex-direction:column;margin-left:.5vw;margin-right:.5vw}div.item2 .input-wrapper .input-actions .clear-input,div.item2 .input-wrapper .input-actions .send-input,div.item2 .input-wrapper .input-actions .send2-input{box-sizing:border-box;background-color:#333;color:#fff;border:none;padding:10px;cursor:pointer;border-radius:50%;width:40px;height:40px;margin-bottom:5px;transition:background-color .3s}div.item2 .input-wrapper .input-actions .send-input{background:#992900}div.item2 .input-wrapper .input-actions .send-input:hover{background:#ff4500}div.item2 .input-wrapper .input-actions .send2-input{background:#0d7661}div.item2 .input-wrapper .input-actions .send2-input:hover{background:#14bb9a}div.item2 .input-wrapper .input-actions .clear-input{background:#333;color:#e6e6e6}div.item2 .input-wrapper .input-actions .clear-input:hover{background:#595959;color:#33e9c5}.menu-open .container{margin-left:16vw}.menu-open .menu-box{left:0!important}div.menu-h{background-color:#1a1a1a;position:fixed;top:0;left:0;width:100vw;height:4.5vh;padding:0;margin:0;outline:0;box-shadow:0 0 0 2px #4d4d4d;z-index:100}div.menu-h .release{background:inherit;color:#ff6a33;font-weight:700;margin-left:57vw;margin-top:.5vh}div.menu-h .menu-btn{appearance:none}div.menu-h .menu-btn:checked+.menu-icon{border:1px solid #333}div.menu-h .menu-btn:checked+.menu-icon .nav-icon{transform:rotate(45deg)}div.menu-h .menu-btn:checked+.menu-icon .nav-icon::before{top:0}div.menu-h .menu-btn:checked+.menu-icon .nav-icon::after{top:0;transform:rotate(90deg)}div.menu-h .menu-icon{box-sizing:border-box;background-color:inherit;display:block;position:absolute;margin-left:2vw;top:0;left:0;width:4vw;height:4.5vh;cursor:pointer;padding:2px;z-index:1}div.menu-h .menu-icon:hover .nav-icon,div.menu-h .menu-icon:hover .nav-icon::after,div.menu-h .menu-icon:hover .nav-icon::before{background-color:#33e9c5}div.menu-h .menu-icon .nav-icon{background-color:#aea7a7;display:block;position:absolute;top:14px;left:0;width:25px;height:2px;transition-duration:.25s}div.menu-h .menu-icon .nav-icon::after,div.menu-h .menu-icon .nav-icon::before{content:"";position:absolute;left:0;background-color:inherit;width:inherit;height:inherit}div.menu-h .menu-icon .nav-icon::before{top:-8px}div.menu-h .menu-icon .nav-icon::after{top:8px}div.menu-h .head-wrapper{position:absolute;top:0;left:5vw;height:4vh;padding:0;margin:0;display:inline-flex;flex-direction:row;flex-wrap:nowrap;align-items:center;justify-content:flex-start}div.menu-h .head-wrapper .help,div.menu-h .head-wrapper .log,div.menu-h .head-wrapper .upload,div.menu-h .head-wrapper .upload-dir{margin-top:2px;margin-left:30px;margin-right:0;padding:5px 5px 0;border:none;cursor:pointer;border-radius:20%;font-size:20px;color:#fff;background:#333;max-height:4vh}div.menu-h .head-wrapper .help:hover,div.menu-h .head-wrapper .log:hover,div.menu-h .head-wrapper .upload-dir:hover,div.menu-h .head-wrapper .upload:hover{background:#595959}div.menu-h .upload,div.menu-h .upload-dir{transition:background-color .3s,transform .3s}div.menu-h .upload .icon,div.menu-h .upload-dir .icon{fill:#FFFFFF;width:24px;height:24px}div.menu-h .upload .icon:hover,div.menu-h .upload-dir .icon:hover{fill:#33e9c5}div.menu-h .log{font-size:14px!important;font-weight:400!important;background:#992900!important}div.menu-h .log:hover{background:#cc3700!important}div.menu-h .log.active{background:#0d7661!important}div.menu-h .log.active:hover{background:#12a487!important}div.menu-h div.menu-box{position:fixed;top:5vh;left:-2000px;height:95vh;width:16vw;transition:left .3s ease-out;padding:1vh 0 0 .5vw;z-index:101;background:#0d0d0d;box-sizing:border-box;outline:0;box-shadow:0 0 0 2px #4d4d4d;display:flex;flex-direction:column;flex-wrap:nowrap;justify-content:flex-start;align-items:stretch;overflow-y:auto;overflow-x:auto}div.menu-h div.menu-box ul{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;border-top:1px solid #333}div.menu-h div.menu-box ul li{border-left:1px solid #333;border-right:1px solid #333;border-bottom:1px solid #333}div.menu-h div.menu-box ul li a{color:#fff;font-size:14px;font-family:arial,verdana,Helvetica,sans-serif;font-weight:400;display:block;margin:0;padding:2px 2px 2px 0;text-align:left;text-decoration:none}div.menu-h div.menu-box ul li:hover{text-decoration:underline;background-color:#333;color:#33e9c5}div.menu-h div.menu-box ul a.delete{text-align:center;font-weight:700;font-style:italic;color:#000;background:#b3a80b}div.menu-h div.menu-box ul a.help{text-align:center;font-weight:700;font-style:italic;color:#000;background:#cc3700}div.menu-h div.menu-box ul li.show{background:#000;color:#fff;width:100%;text-align:center;box-sizing:border-box}div.menu-h div.menu-box ul li.show:hover{text-decoration:none}.window-text{position:relative;top:0;left:0;background:#1a1a1a;color:#fff;border:none;padding:0 2px 2px;width:78vw;height:80vh;border-radius:10px;box-sizing:border-box;outline:0;box-shadow:0 0 0 2px #b3a80b;overflow-y:auto}.window-text pre.pre-text{color:#f8f292;white-space:pre-wrap;word-wrap:break-word;font-family:Georigia,"Ties New Roman",serif;font-size:18px;line-height:1.6;padding:2px;margin:0;text-align:left}.window-text div.text{font-size:18px;font-weight:400;padding-left:10px;padding-right:10px;margin:0}.window-text div.text pre{white-space:pre-wrap;word-wrap:break-word;font-family:arial,verdana,Helvetica,sans-serif;font-size:18px;line-height:1.3;padding:0 5px;margin:0;text-align:left}.window-text div.text .center{text-align:center;font-size:18px;font-weight:700;text-decoration:underline;font-style:italic;color:#e3d50e}.window-text div.text div{font-family:arial,verdana,Helvetica,sans-serif;font-size:18px;font-weight:700;padding-top:0;padding-bottom:0}.window-text div.text div a{background:#000;color:#fff;font-weight:400}.window-text div.text div a:hover{background:#333;color:#fff}.window-text div.text p{font-size:18px;font-weight:400;font-family:arial,verdana,Helvetica,sans-serif;text-align:justify;padding-bottom:9px;padding-right:0;padding-left:10px}.btn-wrapper{width:100%;height:2vw;position:sticky;top:0;padding:0;background:#262626}.btn-wrapper .btn-copy{position:absolute;top:1px;right:5vw;box-sizing:border-box;background:inherit;color:#fff;border:none;cursor:pointer;width:30px;margin:0;padding:0;transition:background-color .3s}.btn-wrapper .btn-copy:hover{background-color:#595959}.btn-wrapper .btn-copy .copy-icon{fill:#e6e6e6;width:20px;height:20px}.btn-wrapper .btn-copy .copy-icon:hover{fill:#33e9c5;background:#404040}.btn-wrapper .btn-close{position:absolute;top:0;right:2vw;margin:0;background-color:transparent;border:none;color:#e6e6e6;font-size:22px;font-weight:700;cursor:pointer;outline:0}.btn-wrapper .btn-close:hover{color:#33e9c5;background:#404040}.msg{box-sizing:border-box;position:fixed;width:300px;height:100px;top:50%;left:50%;transform:translate(-50%,-50%);background-color:#222;color:#ffeb3b;border:2px solid #ffeb3b;border-radius:15px;display:flex;align-items:center;justify-content:center;font-family:Arial,sans-serif;font-size:24px;font-weight:700;text-align:center;z-index:1000;box-shadow:0 4px 8px rgba(0,0,0,.2)}.alert,.confirm{background-color:#303030!important;color:#fff;padding:20px;border-radius:4px;box-shadow:0 2px 4px #00000033!important}.alert .button,.confirm .button{background-color:#37474f!important;color:#fff;border:none;padding:10px 20px;border-radius:4px;cursor:pointer;margin-top:20px}.alert .button:hover,.confirm .button:hover{background-color:#222c31}

static/data/help_test.html

@@ -0,0 +1,25 @@
+<div class="text">
+    <br>
+    <div><a href="#" onCLick="esempio('aaron_swartz.txt');">Aaron Swartz</a></div>
+    <br>
+    <div><a href="#" onCLick="esempio('roberto_busa.txt');">Roberto Busa</a></div>
+    <br>
+    <div><a href="#" onCLick="esempio('la_cattedrale_e_il_bazaar.txt');">La cattedrale e il Bazar</a></div>
+    <br>
+    <div><a href="#" onCLick="esempio('aristotele_detective.txt');">Aristotele Detective</a></div>
+    <br>
+    <div><a href="#" onCLick="esempio('montecristo.txt');">Montecristor</a></div>
+    <br>
+    <div><a href="#" onCLick="esempio('il_libro_rosso.txt');">Il libro rosso</a></div>
+    <br>
+    <div><a href="#" onCLick="esempio('lettere_musulmane.txt');">Lettere Mussulmane</a></div>
+
+    <!--    
+aaron_swartz.txt
+aristotele_detective.txt
+il_libro_rosso.txt
+la_cattedrale_e_il_bazaar.txt
+lettere_musulmane.txt
+montecristo.txt
+roberto_busa.txt
+-->

static/data/la_cattedrale_e_il_bazaar.txt

@@ -0,0 +1,804 @@
+La cattedrale e il bazaar  
+ 
+di Eric S. Raymond 
+(22/11/1998 ore 04:01:20) 
+Quella che segue è la mia analisi di un progetto open source di successo, fetchmail, deliberatamente 
+utilizzato come test specifico per la verifica di alcune sorprendenti teorie sullo sviluppo del software 
+suggerite dalla storia di Linux. Le mie argomentazioni su tali teorie mettono a confronto due diversi stili di 
+sviluppo, il modello “cattedrale” in voga in gran parte del mondo commerciale, opposto al modello 
+“bazaar” del mondo Linux. Da qui passo poi a dimostrare come tali modelli derivino da premesse 
+divergenti sulla natura dell'attività di debugging del software. Arrivo quindi a stabilire la validità 
+dell'esperienza di Linux riguardo l'affermazione “Con molti occhi puntati addosso, ogni bug diventa una 
+bazzecola”, per suggerire analogie produttive con altri sistemi di agenti indipendenti in grado di auto-
+correggersi, concludendo infine con una serie di riflessioni sulle implicazioni di queste analisi per il futuro 
+del software.  
+ 
+1. La cattedrale e il bazaar 
+Linux è sovversivo. Chi avrebbe potuto pensare appena cinque anni fa che un sistema operativo di livello 
+mondiale sarebbe emerso come per magia dal lavoro part-time di diverse migliaia di hacker e sviluppatori 
+sparsi sull'intero pianeta, collegati tra loro solo grazie ai tenui cavi di Internet?  
+Certamente non il sottoscritto. Quando Linux fece la sua comparsa nel mio raggio d'azione all'inizio del 
+1993, mi ero occupato dello sviluppo di Unix e di software open source per dieci anni. Ero stato uno dei 
+primi collaboratori al progetto GNU a metà anni '80. Avevo distribuito su Internet un buon numero di 
+software open source, realizzando da solo o in collaborazione con altri parecchi programmi (nethack, 
+Emacs VC e GUD, xlife, etc.) ancor'oggi ampiamente utilizzati. Pensavo di sapere come bisognasse fare.  
+Linux stravolse gran parte di quel che credevo di sapere. Per anni avevo predicato il vangelo Unix degli 
+strumenti agili, dei prototipi immediati e della programmazione evolutiva. Ma ero anche convinto che 
+esistesse un punto critico di complessità al di sopra del quale si rendesse necessario un approccio 
+centralizzato e a priori. Credevo che il software più importante (sistemi operativi e strumenti davvero 
+ingombranti come Emacs) andasse realizzato come le cattedrali, attentamente lavorato a mano da 
+singoli geni o piccole bande di maghi che lavoravano in splendido isolamento, senza che alcuna versione 
+beta vedesse la luce prima del momento giusto. 
+Rimasi non poco sorpreso dallo stile di sviluppo proprio di Linus Torvalds – diffondere le release presto e 
+spesso, delegare ad altri tutto il possibile, essere aperti fino alla promiscuità. Nessuna cattedrale da 
+costruire in silenzio e reverenza. Piuttosto, la comunità Linux assomigliava a un grande e confusionario 
+bazaar, pullulante di progetti e approcci tra loro diversi (efficacemente simbolizzati dai siti contenenti 
+l'archivio di Linux dove apparivano materiali prodotti da chiunque). Un bazaar dal quale soltanto una 
+serie di miracoli avrebbe potuto far emergere un sistema stabile e coerente. 
+Il fatto che questo stile bazaar sembrasse funzionare, e anche piuttosto bene, mi colpì come uno shock. 
+Mentre imparavo a prenderne le misure, lavoravo sodo non soltanto sui singoli progetti, ma anche 
+cercando di comprendere come mai il mondo Linux non soltanto non cadesse preda della confusione più 
+totale, ma al contrario andasse rafforzandosi sempre più a una velocità a malapena immaginabile per 
+quanti costruivano cattedrali.  
+Fu verso la metà del 1996 che mi parve d'essere sul punto di capirne il perché. Il destino mi offrì 
+l'occasione propizia per mettere alla prova la mia teoria, sotto forma di un progetto open source del quale 
+ decisi di occuparmi usando coscientemente lo stile bazaar. Ci provai, e il successo ottenuto fu piuttosto 
+significativo.  
+Nella parte restante di questo saggio, racconto la storia di quel progetto, usandola per proporre alcuni 
+aforismi sull'efficacia dello sviluppo open source. Non che li abbia imparati tutti dal mondo Linux, ma 
+vedremo come le modalità offerte da quest'ultimo siano del tutto peculiari. Se non ho interpretato male, 
+questi aforismi ci aiuteranno a comprendere con esattezza cos'è che rende la comunità Linux una 
+sorgente così copiosa di buon software – e aiuteranno tutti noi a divenire più produttivi.  
+2. La posta deve passare 
+Dal 1993 mi occupo del lato tecnico di un piccolo provider Internet gratuito chiamato Chester County 
+InterLink (CCIL) in West Chester, Pennsylvania (sono tra i fondatori di CCIL e autore del software 
+specifico per il nostro bulletin-board multiutenti – si può dare un'occhiata facendo telnet su locke.ccil.org . 
+Ora dà accesso a quasi tremila utenti su trenta linee). Grazie a questo lavoro posso collegarmi a Internet 
+per 24 ore al giorno con una linea a 56K di CCIL – in realtà, è proprio quel che mi viene richiesto!  
+Di conseguenza sono ormai abituato alle email istantanee. Per vari motivi, era difficile far funzionare la 
+connessione SLIP tra la mia macchina a casa (snark.thyrsus.com) e CCIL. Quando finalmente ci sono 
+riuscito, mi dava fastidio dover fare ogni tanto telnet su locke per controllare la posta. Volevo fare in 
+modo che i messaggi arrivassero direttamente su snark così da esserne tempestivamente avvisato e 
+poterli gestire a livello locale.  
+Il semplice “sendmail forwarding” non avrebbe funzionato, perché la mia macchina personale non è 
+sempre online e non ha un indirizzo IP statico. Mi serviva un programma in grado di raggiungere la 
+connessione SLIP e tirar via la posta per farla arrivare localmente. Sapevo dell'esistenza di simili cose, e 
+del fatto che in genere facevano uso di un semplice protocollo noto come POP (Post Office Protocol). E 
+sicuramente doveva già esserci un server POP3 incluso nel sistema operativo BSD/OS di locke. 
+Mi serviva un client POP3. Ne ho localizzato subito uno online. Anzi, ne ho trovati tre o quattro. Per un 
+po' ho usato un pop-perl, ma era privo di quella che pareva una funzione ovvia, la capacità di effettuare 
+un “hacking degli indirizzi della posta prelevata in modo che il reply funzionasse correttamente.  
+Questo il problema: supponiamo di ricevere un messaggio da qualcuno di nome 'joe' su locke. Se lo 
+inoltro su snark e poi cerco di fare reply, il mio programma di posta proverebbe simpaticamente a inviarlo 
+a un inesistente 'joe' su snark. Modificare a mano ogni indirizzo per aggiungere “@ccil.org” diventerebbe 
+in un attimo un problema serio.  
+Chiaramente questa era un'operazione che toccava fare al computer per conto mio. Ma nessuno dei 
+client POP esistenti sapeva come! E questo ci porta alla prima lezione: 
+1. Ogni buon lavoro software inizia dalla frenesia personale di uno sviluppatore. 
+Forse ciò avrebbe dovuto risultare ovvio (è risaputo da tempo che “la necessità è la madre di tutte le 
+invenzioni”), ma troppo spesso gli sviluppatori trascorrono le giornate impegnati a guadagnarsi da vivere 
+con programmi di cui non hanno alcun bisogno e che non apprezzano. Ma non nel mondo Linux – il che 
+spiega l'alta qualità media del software originato dalla comunità Linux. 
+Mi sono forse lanciato in un'attività frenetica per scrivere il codice di un client POP3 nuovo di zecca in 
+grado di competere con quelli esistenti? Nemmeno per sogno! Ho esaminato attentamente le utility POP 
+che avevo in mano, chiedendomi: “qual'è la più vicina a quel che sto cercando?” Perché:  
+2. I bravi programmatori sanno cosa scrivere. I migliori sanno cosa riscrivere (e riusare). 
+ Pur non ritenendomi un programmatore tra i più bravi, cerco di imitarli. Importante caratteristica di costoro 
+è una sorta di ozio costruttivo. Sanno che si ottiene il meglio non per le energie impiegate ma per il 
+risultato raggiunto, e che quasi sempre è più facile iniziare da una buona soluzione parziale piuttosto che 
+dal nulla assoluto. 
+Linus Torvalds, per esempio, non ha mai cercato di riscrivere Linux da zero. È invece partito riutilizzando 
+codici e idee riprese da Minix, piccolo sistema operativo per macchine 386 assai simile a Unix. Alla fine il 
+codice Minix è scomparso oppure è stato completamente riscritto – ma per il tempo che è rimasto lì 
+presente è servito come impalcatura per l'infante che sarebbe infine divenuto Linux.  
+Con lo stesso spirito, mi sono messo a cercare una utility POP basata su codici ragionevolmente ben 
+fatti, da utilizzare come base di sviluppo. 
+La tradizione di condivisione dei codici tipica del mondo Unix ha sempre favorito il riutilizzo dei sorgenti 
+(questo il motivo per cui il progetto GNU ha scelto come sistema operativo di base proprio Unix, 
+nonostante alcune serie riserve sullo stesso). Il mondo Linux ha spinto questa tradizione vicina al suo al 
+limite tecnologico; sono generalmente disponibili terabyte di codice open source. È quindi probabile che, 
+impiegando del tempo a cercare il lavoro di qualcuno quasi ben fatto, si ottengano i risultati voluti. E ciò 
+vale assai più nel mondo Linux che altrove.  
+Proprio quel che è successo a me. Conteggiando i programmi trovati prima, con la seconda ricerca 
+ottenni un totale di nove candidati – fetchpop, PopTart, get-mail, gwpop, pimp, pop-perl, popc, popmail e 
+upop. Il primo su cui mi sono concentrato è stato 'fetchpop' di Seung-Hong Oh. Ho inserito l'opzione 
+“header-rewrite” e ho apportato altri miglioramenti, poi accettati dall'autore nella release 1.9.  
+Alcune settimane dopo, però, mi sono imbattuto nel codice di 'popclient' scritto da Carl Harris, ed mi sono 
+trovato di fronte a un problema. Pur offrendo alcune buone idee originali (come la modalità “daemon”), 
+fetchpop poteva gestire solo POP3 e il codice rifletteva un certo approccio da dilettante (Seung-Hong era 
+un programmatore brillante ma inesperto, ed entrambe le qualità risultavano evidenti). Il codice di Carl 
+era migliore, alquanto professionale e solido, ma il suo programma difettava di varie opzioni presenti in 
+fetchpop, opzioni importanti e piuttosto complesse da implementare (incluse quelle aggiunte dal 
+sottoscritto).  
+Restare o cambiare? Nel secondo caso avrei buttato via il codice che avevo già scritto in cambio di una 
+migliore base di sviluppo.  
+Un motivo pratico per passare all'altro programma era il supporto per protocolli multipli. POP3 è il più 
+usato tra i server per l'ufficio postale, ma non è il solo. Fetchpop e l'altro rivale non avevano POP2, 
+RPOP, o APOP, e io stesso stavo meditando, giusto per divertimento, l'aggiunta di IMAP (Internet 
+Message Access Protocol, il protocollo per l'ufficio postale più recente e più potente). 
+Avevo però altri motivi teorici per ritenere una buona idea il fatto di cambiare, qualcosa che avevo 
+imparato molto tempo prima di Linux.  
+3. “Preparati a buttarne via uno; dovrai farlo comunque.” (Fred Brooks, “The Mythical Man-Month”, 
+Capitolo 11)  
+In altri termini, spesso non si riesce a comprendere davvero un problema fino alla prima volta in cui si 
+prova a implementarne la soluzione. La seconda volta forse se ne sa abbastanza per riuscirci. Per 
+arrivare alla soluzione, preparati a ricominciare almeno una volta.  
+Be', mi son detto, la mia prima volta erano state le modifiche a fetchpop. Adesso era ora di cambiare, e 
+così feci. 
+ Dopo aver mandato a Carl Harris il 25 Giugno 1996 una prima serie di aggiustamenti per popclient, mi 
+resi conto che da qualche tempo egli aveva perso interesse nel programma. Il codice era un po' 
+polveroso, con vari bug in giro. Avrei dovuto fare molte modifiche, e ci mettemmo rapidamente d'accordo 
+sul fatto che la cosa più logica fosse che il programma passasse in mano mia.  
+Senza che me ne accorgessi più di tanto, il progetto era cresciuto parecchio. Non mi stavo più 
+occupando soltanto di sistemare i piccoli difetti di un client POP già esistente. Mi ero addossato l'intera 
+gestione di un programma, e mi venivano in mente delle idee che avrebbero probabilmente portato a 
+modifiche radicali. 
+In una cultura del software che incoraggia la condivisione del codice, non si trattava altro che della 
+naturale evoluzione di un progetto. Questi i punti-chiave: 
+4. Se hai l'atteggiamento giusto, saranno i problemi interessanti a trovare te.  
+Ma l'atteggiamento di Carl Harris risultò perfino più importante. Fu lui a comprendere che:  
+5. Quando hai perso interesse in un programma, l'ultimo tuo dovere è passarlo a un successore 
+competente. 
+Senza neppure parlarne, io e Carl sapevamo di perseguire il comune obiettivo di voler raggiungere la 
+soluzione migliore. L'unica questione per entrambi era stabilire se le mie fossero mani fidate. Una volta 
+concordato su questo, egli agì con gentilezza e prontezza. Spero di comportarmi altrettanto bene quando 
+verrà il mio turno.  
+3. L'importanza di avere utenti 
+E così ho ereditato popclient. Fatto parimenti importante, ho ereditato gli utenti di popclient. Importante 
+non soltanto perché la loro esistenza testimonia che stai rispondendo a un loro bisogno, che hai fatto 
+qualcosa di buono. Coltivati in maniera appropriata, gli utenti possono trasformarsi in co-sviluppatori.  
+Altro punto di forza della tradizione Unix, portato felicemente agli estremi da Linux, è che molti utenti 
+sono essi stessi degli hacker. Ed essendo i sorgenti disponibili a tutti, posso diventare degli hacker molto 
+efficaci. Qualcosa di tremendamente utile per ridurre il tempo necessario al debugging. Con un po' 
+d'incoraggiamento, ogni utente è in grado di diagnosticare problemi, suggerire soluzioni, aiutare a 
+migliorare il codice in maniera impensabile per una persona sola.  
+6. Trattare gli utenti come co-sviluppatori è la strada migliore per ottenere rapidi miglioramenti del codice 
+e debugging efficace.  
+È facile sottovalutare la potenza di un simile effetto. In realtà un po' tutti noi del mondo open source 
+eravamo soliti sottovalutare drasticamente il fatto che tale potenza crescesse di pari passo con il numero 
+degli utenti e con la complessità del sistema. Finché Linus Torvalds ci ha mostrato le cose in maniera 
+diversa.  
+In realtà ritengo che la mossa più scaltra e consequenziale di Linus non sia stata la costruzione del 
+kernel di Linux in sé, bensì la sua invenzione del modello di sviluppo di Linux. Quando ho espresso 
+questo mio pensiero in sua presenza, sorridendo ha ripetuto con calma quel che va spesso affermando: 
+“Praticamente sono una persona molto pigra cui piace prendersi il merito di quel che sono gli altri a fare.” 
+Pigro come una volpe. Oppure, come avrebbe detto Robert Heinlein, troppo pigro per fallire. 
+Guardando all'indietro, un precedente per i metodi e il successo di Linux può esser trovato nello sviluppo 
+della libreria Lisp GNU e per gli archivi del codice Lisp di Emacs. In opposizione allo stile di costruzione a 
+ cattedrale del nucleo centrale in C di Emacs e di gran parte di altri strumenti della Free Software 
+Foundation (FSF), l'evoluzione del codice Lisp risultò assai fluida e guidata dagli utenti. Idee e prototipi 
+vennero spesso riscritti tre o quattro volte prima di raggiungere una forma stabile e definitiva. E le 
+collaborazioni estemporanee tra due o più persone consentite da Internet, alla Linux, erano evento 
+frequente.  
+Non a caso il mio caso di “hack” precedente a fetchmail fu probabilmente la modalità Emacs VC, una 
+collaborazione via email secondo lo stile Linux con altre tre persone, soltanto una delle quali (Richard 
+Stallman, autore di Emacs e fondatore della FSF http://www.fsf.org) ho poi avuto occasione di incontrare 
+dal vivo. Si trattava di realizzare il frontale per SCCS, RCS e più tardi CVS dall'interno di Emacs, dotato 
+di opzioni a “one-touch” per le operazioni di controllo. Ciò ha preso avvio da un minuto, crudo sccs.el 
+scritto da qualcun altro. E lo sviluppo di VC ha avuto successo perché, al contrario dello stesso Emacs, il 
+codice 
+di 
+Lisp 
+riuscì 
+a 
+passare 
+molto 
+rapidamente 
+tra 
+diverse 
+generazioni 
+di 
+distribuzione/test/miglioramenti.  
+4. Distribuire presto e spesso 
+Elemento centrale del processo di sviluppo di Linux è la rapida e frequente distribuzione delle varie 
+release. La maggior parte degli sviluppatori (incluso il sottoscritto) aveva sempre considerato negativa 
+questa usanza per progetti appena più che minimi, poiché le versioni iniziali sono piene di bug quasi per 
+definizione e non pareva il caso di far spazientire inutilmente gli utenti. 
+Tale opinione era rinforzata dalla generale aderenza allo stile di sviluppo della costruzione a cattedrale. 
+Se l'obiettivo finale era quello di far vedere meno bug possibili agli utenti, allora conveniva distribuire una 
+nuova release ogni sei mesi (o ancora meno frequentemente) e lavorare duramente sul debugging tra 
+una release e l'altra. Fu seguendo questo processo che venne sviluppato il nucleo centrale in C di 
+Emacs. Ma non fu così per la libreria Lisp –perché erano attivi archivi Lisp al di fuori del controllo della 
+FSF, dove era invece possibile trovare versioni di codice nuovo e in fase di sviluppo indipendentemente 
+dal ciclo di release di Emacs. 
+Il più importante di tali archivi, l'archivio elisp dell'Ohio State, anticipava lo spirito e molte delle 
+caratteristiche tipiche dei grandi archivi su Linux di oggi. Ma pochi di noi si resero davvero conto di quel 
+che stavamo facendo, o di come l'esistenza stessa di quell'archivio paresse rispondere ai problemi insiti 
+nel modello di sviluppo della costruzione a cattedrale della FSF. Verso il 1992 ho provato a far confluire 
+formalmente gran parte del codice dell'Ohio nella libreria ufficiale Lisp di Emacs. Mi sono trovato 
+politicamente nei guai e di fronte a un chiaro insuccesso. 
+Ma l'anno seguente, mentre Linux diventava ampiamente visibile, fu chiaro come stesse accadendo 
+qualcosa di assai diverso e più salutare. La policy di sviluppo aperto di Linus rappresentava l'esatto 
+opposto della costruzione a cattedrale. Gli archivi di sunsite e tsx-11 stavano moltiplicandosi, le 
+distribuzioni multiple andavano proliferando. E tutto ciò sotto la spinta della diffusione, con una frequenza 
+mai vista prima, delle varie release. 
+Linus trattava gli utenti al pari di co-sviluppatori nella maniera più efficace possibile: 
+7. Distribuisci presto. Distribuisci spesso. E presta ascolto agli utenti.  
+L'innovazione introdotta da Linus non consisteva tanto nel seguire questa pratica (qualcosa di simile 
+faceva parte da molto tempo della tradizione del mondo Unix), quanto piuttosto nel farla crescere a un 
+tale livello d'intensità da raggiungere la medesima complessità del lavoro di programmazione che stava 
+facendo. A quei tempi (intorno al 1991) non era raro che egli diffondesse versioni del nuovo kernel anche 
+più di una volta al giorno! Qualcosa che poté funzionare grazie all'attenzione dedicata ai co-sviluppatori e 
+all'ampio utilizzo di Internet come strumento di collaborazione.  
+ Ma come funzionava? Era qualcosa che avrei potuto duplicare, o tutto dipendeva esclusivamente dal 
+genio di Linus Torvalds?  
+No, non lo credevo. Certo, Linus è un gran bell'hacker (quanti di noi saprebbero realizzare per intero un 
+sistema operativo di qualità?). Ma a livello concettuale Linux non rappresentava alcun significativo salto 
+in avanti. Linus non è (almeno, non ancora) quel genio innovativo del design allo stesso modo, ad 
+esempio, di Richard Stallman o James Gosling (di NeWS e Java). Piuttosto, Linus mi sembrava un genio 
+dell'engineering, dotato di un sesto senso per evitare bug e strade senza uscita, oltre che di un ottimo 
+fiuto per arrivare dal punto A al punto B con il minimo sforzo possibile. Non a caso l'intero design di Linux 
+trasuda queste qualità e rispecchia l'approccio essenzialmente conservativo e semplificativo tipico di 
+Linus. 
+Se, quindi, la rapida diffusione delle release e il pieno sfruttamento del medium Internet non erano 
+casuali, bensì parti integranti delle visioni da genio dell'engineering di Linus lungo il cammino del minimo 
+sforzo possibile, cos'era che stava amplificando? Cos'è che riusciva a tirar fuori da tutto questo gran 
+daffare? 
+Messa così, la domanda si risponde da sola. Linus tendeva a stimolare e ricompensare costantemente i 
+suoi hacker/utenti – stimolati dalla soddisfazione di sé per aver preso parte all'azione, ricompensati dalla 
+vista dei miglioramenti costanti (perfino giornalieri) ottenuti nel loro lavoro.  
+Linus puntava direttamente a massimizzare il numero di ore/uomo coinvolte nello sviluppo e nel 
+debugging, rischiando perfino la possibile instabilità del codice e l'estinguersi del contributo degli utenti 
+qualora fosse risultato impossibile tener traccia di qualche serio bug. Linus si comportava seguendo una 
+concezione più o meno riassumibile come segue: 
+8. Stabilita una base di beta-tester e co-sviluppatori sufficientemente ampia, ogni problema verrà 
+rapidamente definito e qualcuno troverà la soluzione adeguata. 
+O, in modo meno formale, “Dato un numero sufficiente di occhi, tutti i bug vengono a galla”. Io la chiamo 
+la “Legge di Linus”. 
+La mia formulazione originale era che ogni problema “diventerà trasparente per qualcuno”. Linus fece 
+notare come la persona che si rende conto e risolve il problema non necessariamente né di norma è la 
+stessa persona che per prima lo mette a fuoco. “Qualcuno scopre il problema,” dice Linus, “e qualcun 
+altro lo comprende. E secondo me il compito più difficile è proprio trovarlo”. Ma il punto è che entrambe le 
+cose tendono ad accadere piuttosto rapidamente.  
+Questa ritengo che sia la differenza fondamentale tra lo stile a cattedrale e quello a bazaar. Nel primo 
+caso la visualizzazione dei problemi relativi a programmazione, bug e sviluppo costituiscono fenomeni 
+dubbi, insidiosi, complessi. Servono mesi di scrutinio ravvicinato da parte di più d'uno per poi sentirsi 
+sicuri di aver risolto tutti i problemi. Da qui i lunghi intervalli tra le release, e l'inevitabile delusione quando 
+le versioni così a lungo attese si rivelano imperfette. 
+Nella concezione a bazaar, d'altra parte, si dà per scontato che generalmente i bug siano fenomeni 
+marginali – o che almeno divengano rapidamente tali se esposti all'attenzione di migliaia di volenterosi 
+co-sviluppatori che soppesano ogni nuova release. Ne consegue la rapidità di diffusione per ottenere 
+maggiori correzioni, e come positivo effetto collaterale, c'è meno da perdere se viene fuori qualche toppa 
+raffazzonata.  
+Tutto qui. E non è certo poco. Se la “Legge di Linus” è falsa, allora ogni sistema complesso tanto quanto 
+il kernel Linux, ricavato grazie al lavoro collettivo delle molte mani che lo hanno messo insieme, a un 
+certo punto avrebbe dovuto crollare sotto il peso di interazioni negative impreviste e di “profondi” bug non 
+scoperti. Se invece è vera, allora è sufficiente a spiegare la relativa assenza di bug di Linux. 
+ E forse ciò non dovrebbe rappresentare affatto una sorpresa. Qualche anno addietro sono stati i 
+sociologi a scoprire che l'opinione media di un gruppo di osservatori equamente esperti (o equamente 
+ignoranti) si rivela parametro assai più affidabile di quella di un solo osservatore scelto casualmente in 
+quel gruppo. Si tratta del cosiddetto “effetto Delfi”. Ora sembra che Linus abbia dimostrato come ciò vada 
+applicato anche all'operazione di debugging di un sistema operativo – ovvero che l'effetto Delfi è in grado 
+di addomesticare la complessità della programmazione, persino la complessità del kernel di un sistema 
+operativo. 
+Sono in debito con Jeff Dutky dutky@wam.umd.edu per aver sottolineato come la Legge di Linus possa 
+essere definita anche: “Il debugging è parallelizzabile”. Jeff fa notare come nel corso dell'intero processo, 
+pur richiedendo il coordinamento di uno sviluppatore che curi le comunicazioni tra quanti si occupano del 
+debugging, questi ultimi invece non richiedono particolare coordinamento. In tal modo non si cade preda 
+della notevole complessità e dei costi gestionali imposti dal coinvolgimento di nuovi sviluppatori.  
+In pratica, nel mondo Linux la perdita di efficienza a livello teorico, dovuta alla duplicazione di lavoro da 
+parte di quanti seguono il debugging, non arriva quasi mai a rappresentare un problema. Uno degli effetti 
+della policy “distribuire presto e spesso” è proprio quello di minimizzare tale duplicazione di lavoro 
+propagando rapidamente le soluzioni giunte col feedback degli utenti. 
+Anche Brooks ha fatto un'osservazione su quanto sostenuto da Jeff: “Il costo totale per il mantenimento 
+di un programma ampiamente utilizzato in genere viene valutato intorno al 40 per cento, o più, del costo 
+dello sviluppo. Non senza sorpresa, tale costo viene notevolmente influenzato dal numero di utenti 
+coinvolti. Maggiori sono questi ultimi, più bug si trovano.”  
+Ciò per via del fatto che con un maggior numero di utenti ci sono più modi differenti di verificare il 
+programma. Un effetto amplificato quando costoro sono anche co-sviluppatori. Ciascuno affronta il 
+compito della definizione dei bug con un approccio percettivo e analitico leggermente differente, una 
+diversa angolazione per affrontare il problema. L'effetto Delfi pare funzionare esattamente sulla base di 
+tali differenze. Nel contesto specifico del debugging, le variazioni tendono anche a ridurre la duplicazione 
+degli sforzi impiegati.  
+Quindi, dal punto di vista dello sviluppatore, l'aggiunta di altri beta-tester può non ridurre la complessità 
+del bug “più profondo” attualmente sotto studio, ma aumenta la probabilità che l'approccio di qualcuno 
+consentirà il corretto inquadramento del problema, così che per questa persona il bug non apparirà altro 
+che una bazzecola. 
+Inoltre, in caso di seri bug, le varie versioni del kernel di Linux sono numerate in modo tale che i 
+potenziali utenti possano scegliere o di far girare l'ultima versione definita “stabile” oppure rischiare 
+d'incappare in possibili bug pur di provare le nuove funzioni. Una tattica ancora non formalmente imitata 
+dalla maggior parte di hacker Linux, ma che forse dovrebbe esserlo. Il fatto che entrambe le scelte siano 
+disponibili le rende entrambe più attraenti.  
+5. Quando una rosa non è una rosa?  
+Dopo aver osservato il comportamento di Linus e aver elaborato una mia teoria sul perché d
+el suo 
+successo, ho deciso coscientemente di mettere alla prova tale teoria sul mio nuovo progetto 
+(palesemente assai meno complesso e ambizioso).  
+Per prima cosa però ho semplificato parecchio popclient. Le implementazioni di Carl Harris erano 
+precise, ma mostravano quella complessità inopportuna comune a molti programmatori in C. Trattava il 
+codice come elemento centrale, considerando solo come supporto a latere la struttura dati. Come 
+conseguenza, il codice era eccezionale ma il design strutturale improvvisato e bruttino (almeno secondo 
+gli standard elevati di questo vecchio hacker di LISP).  
+ Oltre al miglioramento del codice e del design strutturale, perseguivo comunque un altro obiettivo 
+nell'operazione di riscrittura. Volevo si evolvesse in qualcosa che fossi in grado di comprendere 
+pienamente. Non c'è alcun divertimento nel sistemare i problemi di un programma che non si comprende 
+appieno. 
+Fu così che mi ci volle tutto il primo mese soltanto per seguire le implicazioni del progetto di base di Carl. 
+La prima vera modifica fu l'aggiunta del supporto per IMAP. In pratica riorganizzai le macchine del 
+protocollo in un driver generico con tre opzioni (per POP2, POP3 e IMAP). Insieme ai cambiamenti 
+precedenti, ciò illustra il principio generale che ogni programmatore dovrebbe tenere bene a mente, 
+soprattutto lavorando con linguaggi come il C che non accettano facilmente gli inserimenti dinamici: 
+9. Meglio combinare una struttura dati intelligente e un codice non eccezionale che non il contrario. 
+Brooks, capitolo 9: “Mostrami [il codice] e nascondimi [la struttura dati], e io continuerò a essere 
+disorientato. Mostrami [la struttura dati], e non avrò bisogno del [codice]; sarà del tutto ovvio.”  
+Per esser precisi, lui parlava di “diagrammi” e “tabelle”. Ma considerando il mutamento lessicale/culturale 
+di questi trent'anni, il senso rimane invariato.  
+A questo punto (inizio Settembre 1996, sei settimane dopo esser partito da zero), ho cominciato a 
+pensare all'opportunità di cambiare il nome – in fondo non si trattava più soltanto di un client POP. Ma 
+esitavo perché mancava ancora qualcosa di genuinamente nuovo nel design. La mia versione di 
+popclient doveva ancora acquisire una propria identità.  
+Il cambio radicale avvenne quando fetchmail imparò come fare il forward della posta prelevata verso la 
+porta SMTP. Lo spiego meglio tra poco. Prima però: più sopra ho parlato della decisione di usare questo 
+progetto come test per verificare la mia teoria sui brillanti risultati raggiunti da Linus Torvalds. Vi potreste 
+chiedere, in che modo l'ho messa alla prova? Ecco come: 
+1. Ho diffuso le varie release presto e spesso (quasi mai a meno di dieci giorni di distanza; una volta 
+al giorno nei periodi d'intenso lavoro).  
+2. Ho inserito nella lista dei beta chiunque mi avesse contattato riguardo fetchmail.  
+3. Ho mandato simpatici messaggi all'intera lista dei beta per annunciare ogni nuova release, 
+incoraggiando la gente a partecipare.  
+4. E ho dato ascolto ai beta tester, ponendo loro domande sul design adottato e plaudendoli ogni 
+volta che mi mandavano aggiustamenti e feedback.  
+Questi semplici accorgimenti produssero una ricompensa immediata. Fin dall'inizio del progetto, mi 
+arrivavano report sui bug presenti di una qualità che qualunque sviluppatore avrebbe invidiato, spesso 
+con buone soluzioni in attach. Ho ricevuto mail piene di critiche costruttive, lodi sperticate, suggerimenti 
+intelligenti. Il che ci porta a: 
+10. Se tratti i beta tester come se fossero la risorsa più preziosa, replicheranno trasformandosi davvero 
+nella risorsa più preziosa a disposizione. 
+Un'interessante caratteristica del successo di fetchmail risiede nell'ampiezza dell'elenco dei beta, i 
+“fetchmail-friend”. Si è rapidamente raggiunta quota 249, con nuovi arrivi due o tre volte la settimana.  
+L'ultima revisione, fine Maggio 1997, ha rivelato che la lista andava perdendo membri, dopo aver 
+raggiunto un massimo di 300 nominativi, e ciò per un motivo degno di nota. In parecchi mi hanno chiesto 
+di essere rimossi perché fetchmail funzionava così bene che non c'era più alcun motivo di seguire il 
+traffico della lista! Forse anche ciò fa parte del normale ciclo di vita di un progetto maturo in stile bazaar.  
+ 6. Popclient diventa Fetchmail 
+Il vero punto di svolta del progetto ebbe luogo quando Harry Hochheiser mi spedì il codice iniziale per 
+fare il forward alla porta SMTP della macchina client. Mi sono reso immediatamente conto che 
+l'implementazione affidabile di tale funzione avrebbe reso pressoché obsoleta ogni altra modalità di 
+consegna della posta. 
+Per molte settimane mi ero messo a giocare con l'interfaccia di fetchmail, passabile ma disordinata – 
+poco elegante e con troppe opzioni sparse tutt'intorno. Tra queste mi davano particolarmente fastidio, 
+anche senza capire perché, quelle utilizzate per trasferire la posta prelevata in una certa mailbox o 
+altrove. 
+Quel che mi veniva in mente pensando alla funzione del “SMTP forwarding” era che popclient voleva 
+cercare di far troppe cose. Era stato ideato per essere sia un “mail transport agent” (MTA) sia un “mail 
+delivery agent” (MDA) a livello locale. Con il forward SMTP avrebbe potuto smettere di essere un MDA 
+per divenire un puro MTA, trasferendo ad altri programmi la posta per la consegna locale, proprio come 
+fa sendmail. 
+Perché darsi da fare a sistemare le complesse configurazioni p
+er un MDA o le impostazioni per le 
+mailbox, quando innanzitutto è quasi sempre garantito che la porta 25 rimane disponibile per questo su 
+ogni piattaforma con supporto TCP/IP? Soprattutto quando ciò significa che i messaggi prelevati 
+appariranno come posta SMTP normalmente inviata dal mittente, che è poi quel che stiamo cercando di 
+ottenere. 
+Ci sono diverse lezioni da trarre a questo punto. Primo, l'idea del “SMTP forwarding” era la prima grossa 
+ricompensa per aver tentato coscientemente di emulare i metodi di Linus. Era stato un utente a 
+suggerirmi questa fantastica idea – non mi restava che comprenderne le implicazioni. 
+11. La cosa migliore, dopo l'avere buone idee, è riconoscere quelle che arrivano dagli utenti. Qualche 
+volta sono le migliori.  
+Fatto interessante, è facile scoprire che se sei completamente onesto e autocritico su quanto è dovuto 
+agli altri, il mondo intero ti tratterà come se ogni bit di quell'invenzione fosse opera tua, mentre impari a 
+considerare con sempre maggior modestia il tuo genio innato. Abbiamo visto come tutto ciò abbia 
+funzionato a meraviglia con Linus!  
+(Quando ho presentato questo scritto alla conferenza su Perl dell'Agosto 1997, in prima fila c'era Larry 
+Wall. Non appena sono arrivato al punto di cui sopra, ha intonato in stile revival-religioso, “Diglielo, 
+diglielo, fratello!” Tutti i presenti si son messi a ridere, perché sapevano come ciò avesse funzionato bene 
+anche per l'inventore di Perl.)  
+Dopo aver lavorato sul progetto nello stesso spirito per alcune settimane, mi son visto arrivare lodi simili 
+non soltanto dagli iscritti alla lista ma anche da altre persone che venivano a sapere della cosa. Ho 
+conservato qualche email; forse me le andrò a rileggere nel caso iniziassi a chiedermi se la mia vita 
+abbia mai avuto un qualche valore :-).  
+Ma ci sono altre due lezioni da trarre, più fondamentali e non politiche, buone per ogni tipo di design.  
+12. Spesso le soluzioni più interessanti e innovative arrivano dal fatto di esserti reso conto come la tua 
+concezione del problema fosse errata.  
+Avevo cercato di risolvere il problema sbagliato continuando a lavorare su popclient in quanto 
+combinazione MTA/MDA con tutte le possibili modalità di consegna della posta. Il design di fetchmail 
+ aveva bisogno di essere reimpostato dall'inizio come un puro MTA, a parte il normale percorso della 
+posta relativo a SMTP. 
+Quando sbatti la testa contro il muro nel lavoro di programmazione – quando cioè non riesci più a 
+pensare alla prossima “patch” – spesso è ora di chiedersi non se hai la risposta giusta, ma se ti stai 
+ponendo la giusta domanda. Forse bisogna inquadrare nuovamente il problema.  
+Be', mi toccò inquadrare meglio il problema. Chiaramente la cosa giusta da fare era (1) posizionare il 
+supporto per il “SMTP forwarding” nel driver generico, (2) farla diventare la funzione default, (3) 
+sbarazzarsi di tutte le altre modalità di consegna della posta, specialmente le opzioni “deliver-to-file” e 
+“deliver-to-standard-output”.  
+Per qualche tempo ho esitato a compiere il passo (3), temendo di avvilire quanti usavano da molto tempo 
+popclient proprio per i diversi meccanismi di consegna. In teoria, avrebbero potuto immediatamente 
+passare ai file “.forward” oppure agli equivalenti “non-sendmail” per ottenere il medesimo effetto. In 
+pratica, però, tale transizione sarebbe risultata impraticabile.  
+Quando mi decisi comunque a farlo, ne risultarono enormi benefici. Le parti più confuse del codice del 
+driver scomparvero. La configurazione divenne radicalmente più semplice – niente più girovagare nel 
+sistema MDA e nella mailbox, niente più preoccupazioni per vedere se il sistema operativo supportasse o 
+meno il blocco dei file. 
+Venne anche eliminata l'unica possibilità di perdere dei messaggi. Se, specificando la consegna in un 
+file, il disco è pieno, la posta va perduta. Impossibile che ciò accada con il “SMTP forwarding” perché 
+l'altro SMTP in ascolto non accetterà l'OK a meno che il messaggio non possa essere correttamente 
+consegnato o almeno filtrato per il prelievo successivo.  
+Inoltre, le prestazioni complessive risultarono migliorate (anche se così non sembra quando lo si fa girare 
+una sola volta). Altro beneficio non insignificante del cambiamento fu che la chiamata manuale risultò 
+assai più semplificata. 
+In seguito fui costretto a reintrodurre la funzione di consegna tramite un MDA locale specificato 
+dall'utente, per consentire la gestione di strane situazioni relative allo SLIP dinamico. Ma riuscii a farlo in 
+maniera più semplice. 
+Morale? Non esitare a buttar via opzioni inanellate una sull'altra quando puoi rimpiazzarle senza perdere 
+in efficienza. Diceva Antoine de Saint-Exupéry (aviatore e designer di aerei, quando non scriveva libri per 
+bambini): 
+13. “La perfezione (nel design) si ottiene non quando non c'è nient'altro da aggiungere, bensì quando 
+non c'è più niente da togliere.”  
+Quando il codice diventa migliore e più semplice, allora vuol dire che va bene. E nel processo, il design 
+di fetchmail acquistò una sua propria identità, diversa dal popclient originario. 
+Era giunta l'ora di cambiar nome. Il nuovo design assomigliava più a sendmail di quanto lo fosse il 
+vecchio popclient; entrambi sono MTA, ma mentre sendmail spinge e poi consegna, il nuovo popclient 
+tira e poi consegna. Così, a due mesi dai blocchi di partenza, decisi di dargli il nuovo nome, fetchmail.  
+7. Fetchmail diventa adulto 
+Eccomi qui con un design ben fatto e innovativo, un codice che ero certo funzionasse bene perchè lo 
+usavo ogni giorno, e una spumeggiante lista di beta tester. Gradualmente mi resi conto che non ero più 
+ indaffarato con uno stupido programmino personale che forse avrebbe potuto interessare pochi altri. 
+Stavo lavorando su un programma di cui ogni hacker dotato di mailbox Unix e connessione SLIP/PPP 
+non avrebbe potuto fare a meno. 
+Grazie all'opzione di “SMTP forwarding”, s
+uperava sicuramente i programmi rivali fino a diventare 
+potenzialmente una “categoria killer”, uno di quei programmi classici che occupano la propria nicchia in 
+maniera perfetta, facendo scartare e quasi dimenticare ogni possibile alternativa.  
+Credo che simili risultati siano impossibili da perseguire o da pianificare. Devi esser trascinato dentro la 
+storia da idee così potenti che, col senno di poi, quei risultati appaiono del tutto inevitabili, naturali, 
+perfino prestabiliti. L'unico modo per provarci è farsi venire un sacco di idee, oppure avere la capacità di 
+portare le idee degli altri al di là del punto in cui essi stessi credevano potessero arrivare. 
+Andrew Tanenbaum ebbe l'idea originale di realizzare un linguaggio di base Unix per il 386, da usare 
+come strumento didattico. Linus Torvalds ha spinto il concetto del Minix ben oltre quanto lo stesso 
+Andrew ritenesse possibile – ed è diventato qualcosa di meraviglioso. Allo stesso modo (pur se su scala 
+minore) io ho preso alcune idee da Carl Harris e Harry Hochheiser, e le ho spinte oltre. Nessuno di noi è 
+stato “originale” nel senso romantico in cui si immagina un genio. Ma a ben vedere la maggior parte della 
+scienza, dell'ingegneria e dello sviluppo del software non viene realizzata da alcun genio originale, il 
+contrario della mitologia dell'hacker. 
+I risultati ottenuti erano piuttosto notevoli – meglio, esattamente quel tipo di successo che ogni hacker 
+sogna! E ciò significa che avrei potuto mirare anche a standard più elevati. Per rendere fetchmail così 
+ben fatto come lo vedevo ora, avrei dovuto scrivere non soltanto per le mie necessità ma anche per 
+includere il supporto di opzioni necessarie ad altri e tuttavia fuori dalla mia orbita. E fare ciò mantenendo 
+al contempo semplice e robusto il programma.  
+La prima funzione di gran lunga più importante che scrissi dopo essermi reso conto di ciò, fu il supporto 
+multiutente – la possibilità di prelevare la posta da più mailbox in cui erano stati accumulati tutti i 
+messaggi per un gruppo di utenti, e quindi smistare ogni singolo messaggio ai rispettivi destinatari. 
+Decisi di aggiungere il supporto multiutente in parte perché alcuni lo richiedevano, ma soprattutto perché 
+pensavo avrebbe buttato via ogni bug dal codice per un solo utente, costringendomi a fare attenzione 
+alla gestione dei vari indirizzi. E così fu. Mi ci volle parecchio tempo per sistemare tutto nella RFC 822, 
+non perché sia difficile mettere a posto ogni singola parte, ma perché coinvolgeva una montagna di 
+dettagli interdipendenti e instabili.  
+In ogni caso, anche la funzione per gli indirizzi multiutenti si rivelò un'ottima decisione. Ecco come me ne 
+sono accorto: 
+14. Ogni strumento dovrebbe rivelarsi utile nella maniera che ci si attende, ma uno strumento davvero 
+ben fatto si presta ad utilizzi che non ci si aspetterebbe mai.  
+L'uso inatteso della funzione multiutenti è per una mailing list quando questa viene mantenuta sul lato 
+client della connessione SLIP/PPP, attivando l'espansione dell'alias. Ne consegue che chi fa girare un 
+PC tramite un account con un provider Internet è in grado di gestire una mailing list senza dover 
+accedere continuamente ai file alias del provider.  
+Altra importante modifica richiesta dai beta tester fu il supporto per operazioni MIME in 8-bit. Qualcosa 
+piuttosto semplice a farsi, poiché avevo fatto bene attenzione a mantenere il codice pulito per inserire l'8-
+bit. Non perché avessi anticipato tale richiesta, quanto piuttosto per rispettare un'altra regola:  
+ 15. Quando si scrive del software per qualunque tipo di gateway, ci si assicuri di disturbare il meno 
+possibile il flusso dei dati – e *mai* buttar via alcun dato a meno che il destinatario non ti ci costringa!  
+Se non avessi rispettato questa regola, il supporto per MIME in 8-bit sarebbe risultato difficile e 
+problematico. Così invece tutto quel che dovetti fare fu leggere la RFC 1652 e aggiungere poche stringhe 
+per far generare l'header. 
+Alcuni utenti europei mi hanno costretto a inserire un'opzione per limitare il numero dei messaggi 
+prelevati a ogni sessione (in modo da controllare i costi di collegamento, per via delle care tariffe imposte 
+dalle aziende telefoniche nazionali). Ho resistito per parecchio tempo, e ancor'oggi non ne sono 
+pienamente soddisfatto. Ma se scrivi programmi per tutto il mondo, devi dare ascolto ai tuoi clienti – e ciò 
+rimane valido anche se non ti ricompensano in denaro.  
+8. Qualche altra lezione da Fetchmail 
+Prima di tornare alle questioni generali sul “software-engineering”, è il caso di considerare qualche altro 
+insegnamento specifico a seguito di quest'esperienza con fetchmail. 
+La sintassi del file rc include una serie di parole-chiave facoltative completamente ignorate 
+dall'analizzatore. La sintassi in “quasi-inglese” che si ottiene è notevolmente più leggibile delle semplici 
+coppie nome/valore che si rimangono dopo aver eliminato le prime.  
+Tutto ebbe inizio come un esperimento a notte fonda dopo essermi accorto di quante fossero le 
+dichiarazioni del file rc che cominciavano ad assomigliare a un minilinguaggio imperativo. (Per lo stesso 
+motivo ho modificato in “poll” la parola-chiave “server” del popclient originale).  
+Mi venne da pensare che sarebbe stato più facile usare qualcosa di simile all'inglese comune piuttosto 
+che quel minilinguaggio imperativo. Ora, pur essendo il sottoscritto un convinto fautore della scuola di 
+design del tipo “trasformalo in linguaggio”, come esemplificato da Emacs, dall'HTML e da molti motori di 
+database, generalmente non mi annovero tra i fan delle sintassi in “quasi-inglese”. 
+Tradizionalmente i programmatori hanno sempre avuto la tendenza a favorire sintassi molto precise e 
+compatte, del tutto prive di ridondanza. Si tratta di un'eredità culturale del tempo in cui le risorse 
+informatiche erano costose, così gli analizzatori dovevano risultare semplici ed economici al massimo 
+grado. Allora l'inglese, con quel 50% di ridondanza, sembrava un modello poco appropriato. 
+Non è questa la ragione per cui generalmente io evito le sintassi in quasi-inglese; l'ho citata qui soltanto 
+per demolirla. Con l'attuale economicità dei cicli e delle strutture, la pulizia non dovrebbe essere un 
+obiettivo in sé. Al giorno d'oggi è più importante che un linguaggio sia conveniente per gli esseri umani 
+anziché economico per il computer.  
+Esistono comunque buoni motivi per procedere con cautela. Uno è rappresentato dai costi della 
+complessità dell'analizzatore – non è il caso di aumentare tale complessità fino a raggiungere il punto in 
+cui produrrà bug significativi e confusione nell'utente. Un'altra ragione è che cercare di rendere un 
+linguaggio in quasi-inglese spesso richiede un tale aggiustamento linguistico che le somiglianze 
+superficiali con il linguaggio naturale generino confusione tanto quanto l'eventuale sintassi tradizionale. 
+(Come si può notare con evidenza nei linguaggi di interrogazione dei database di “quarta generazione” e 
+commerciali). 
+La sintassi di controllo di fetchmail riesce a evitare questi problemi perché il dominio riservato al 
+linguaggio è estremamente limitato. Non si avvicina neppure lontanamente a un linguaggio di tipo 
+generale; le cose che dice non sono affatto complicate, lasciando quindi poco spazio a potenziali 
+ confusioni, quando ci si sposta mentalmente tra un ristretto ambito d'inglese e il linguaggio di controllo 
+vero e proprio. Credo qui si tratti di una lezione di più ampia portata: 
+16. Quando il linguaggio usato non è affatto vicino alla completezza di Turing, un po' di zucchero 
+sintattico può esserti d'aiuto. 
+Un'altra lezione riguarda la sicurezza “al buio”. Alcuni utenti di fetchmail mi avevano chiesto di modificare 
+il software in modo che potesse conservare le password crittografate nel file rc, evitando così il rischio 
+che qualche ficcanaso potesse scoprirle casualmente. 
+Non l'ho fatto perché in realtà ciò non aggiunge alcuna protezione. Chiunque sia stato autorizzato a 
+leggere il file rc, sarebbe comunque in grado di far girare fetchmail – e se è la password che cerca, 
+saprebbe come decodificarla tirandola fuori dallo stesso codice di fetchmail. 
+Qualsiasi possibile codifica della password operata da .fetchmailrc, non avrebbe fatto altro che fornire un 
+falso 
+senso 
+di 
+sicurezza 
+a 
+quelli 
+che 
+non 
+vogliono 
+spremersi 
+le 
+meningi. 
+La regola generale è: 
+17. Un sistema di sicurezza è sicuro soltanto finché è segreto. Meglio diffidare degli pseudo-segreti. 
+9. Le pre-condizioni necessarie per lo stile bazaar  
+I primi lettori e revisori di questo scritto hanno r
+ipetutamente sollevato domande sulle pre-condizioni 
+necessarie per il successo dello sviluppo in stile bazaar, comprendendo con ciò sia le qualifiche del 
+leader del progetto sia lo stato del codice al momento della diffusione pubblica e della nascita della 
+possibile comunità di co-sviluppatori.  
+È alquanto evidente come lo stile bazaar non consenta la scrittura del codice partendo da zero. Si 
+possono fare test, trovare i bug, migliorare il tutto, ma sarebbe molto difficile dar vita dall'inizio a un 
+progetto in modalità bazaar. Linus non lo ha fatto. Neppure io. La nascente comunità di sviluppatori deve 
+avere qualcosa da far girare e con cui giocare. 
+Quando s'inizia a costruire la comunità, bisogna essere in grado di presentare una promessa plausibile. 
+Non è detto che il programma debba funzionare particolarmente bene. Può anche essere crudo, pieno di 
+bug, incompleto, scarsamente documentato. Non deve però mancare di convincere i potenziali co-
+sviluppatori che possa evolversi in qualcosa di veramente ben fatto nel prossimo futuro.  
+Quando Linux e fetchmail vennero diffusi pubblicamente, erano dotati di un design di base forte e 
+attraente. Molte persone ritengono che il modello bazaar da me presentato riveli correttamente questa 
+fase critica, per poi da qui saltare alla conclusione che sia indispensabile un elevato livello di intuizione e 
+bravura da parte di chi guida il progetto.  
+Ma Linus prese il suo design da Unix. All'inizio ho fatto lo stesso con il popclient originario (anche se poi 
+risultò molto diverso, assai più di quanto è accaduto con Linux, fatte le debite proporzioni). È dunque 
+vero che il leader/coordinatore di un progetto in stile bazaar debba possedere un eccezionale talento nel 
+design? Oppure può cavarsela facendo leva sui talenti altrui?  
+Non credo sia essenziale che il coordinatore possa produrre design eccezionali, ma è assolutamente 
+centrale che sia capace di riconoscere le buone idee progettuali degli altri.  
+Ciò appare evidente da entrambi i progetti di Linux e fetchmail. Pur non essendo un designer 
+particolarmente originale (come discusso in precedenza), Linus ha dimostrato un ottima intuizione nel 
+ saper riconoscere il buon design per poi integrarlo nel kernel di Linux. Ed ho già descritto come l'idea più 
+potente di fetchmail (SMTP forwarding) mi sia arrivata da qualcun altro. 
+I primi lettori di questo testo mi hanno fatto i complimenti mettendo a fuoco la mia propensione a 
+sottovalutare l'originalità del design nei progetti in stile bazaar perchè ne possiedo a volontà io stesso, e 
+quindi la dò per scontata. In effetti, c'è qualcosa di vero in quest'affermazione; il design (in alternativa al 
+codice o al debugging) è la mia capacità migliore.  
+Ma il problema con il fatto di essere bravi e originali nel design del software è che tende a divenire 
+un'abitudine – prendi a fare cose carine e complicate quando invece dovresti tenerle semplici e robuste. 
+Proprio per questa ragione mi sono crollati addosso vari progetti, ma con fetchmail sono stato attento a 
+non farlo.  
+Credo insomma che il progetto di fetchmail abbia avuto successo in parte perché ho limitato la mia 
+tendenza a esser bravo; ciò va (almeno) contro l'essenzialità dell'originalità del design per il successo dei 
+progetti a bazaar. Consideriamo Linux. Supponiamo che Linus Torvalds avesse cercato di tirar fuori le 
+innovazioni fondamentali dal design del sistema operativo nel corso dello sviluppo; quali probabilità 
+esistono che il kernel risultante fosse ugualmente stabile ed efficace come quello che abbiamo ora? 
+È chiaro che occorrano capacità di un certo livello per il design e il codice, ma personalmente mi aspetto, 
+da quasi tutte le persone che pensano seriamente di lanciare un progetto bazaar, un livello superiore. Il 
+mercato interno della reputazione della comunità open source esercita una sottile pressione sulle 
+persone in modo che non si lancino dei progetti se non si è abbastanza competenti per seguirli. Finora 
+quest'approccio ha funzionato piuttosto bene.  
+Esiste un altro tipo di capacità normalmente non associata allo sviluppo del software che ritengo 
+importante al pari della bravura nel design per i progetti bazaar – anzi, forse ancora più importante. Il 
+coordinatore o leader deve essere in grado di comunicare efficacemente con gli altri.  
+D'altronde è ovvio che per metter su una comunità di sviluppatori occorra attirare gente, coinvolgerli in 
+quel che stai facendo, tenerli contenti per il lavoro che fanno. Lo sfrigolìo tecnico aiuta molto in questo 
+senso, ma è ben lungi dall'esser tutto. È anche importante il tipo di personalità che proietti.  
+Non è certo una coincidenza che Linus sia un tipo simpatico, capace di piacere alla gente e di farsi 
+aiutare. Da parte mia, io sono un estroverso energetico cui piace lavorare tra la folla, oltre ad avere 
+qualcosa dei modi e dell'istinto del comico. Per far funzionare il modello a bazaar, aiuta parecchio essere 
+in grado di esercitare almeno un po' di fascino sulla gente.  
+10. Il contesto sociale del software open source  
+È proprio vero: le migliori operazioni di hacking nascono come soluzioni personali ai problemi quotidiani 
+dell'autore, e si diffondono perchè si scopre che tali problemi sono comuni a molte altre persone. Questo 
+ci riporta indietro alla questione della regola numero uno, riformulata forse in maniera più consona: 
+18. Per risolvere un problema interessante, comincia a trovare un problema che risvegli il tuo interesse. 
+Così è successo con Carl Harris e l'iniziale popclient, lo stesso con me e fetchmail. Ma ciò era chiaro da 
+molto tempo. Il punto interessante che richiede attenzione, sulla base dell'evolversi di Linux e di 
+fetchmail, è il palcoscenico successivo – l'evoluzione del software in presenza di una vasta e attiva 
+comunità di utenti e co-sviluppatori. 
+In “The Mythical Man-Month”, Fred Brooks osserva come il tempo del programmatore non sia calcolabile; 
+aggiungendo altri sviluppatori ad un progetto in ritardo, lo si fa tardare ancora di più. Secondo lui, i costi 
+ della complessità e delle comunicazioni di un progetto crescono esponenzialmente con il numero degli 
+sviluppatori coinvolti, mentre il lavoro cresce soltanto in senso lineare. Quest'affermazione è nota come 
+la “Legge di Brooks”, ed è considerata una verità pressoché universale. Ma se la Legge di Brooks fosse 
+stata l'unica verità, Linux non sarebbe mai esistito.  
+Il classico di Gerald Weinberg “The Psychology Of Computer Programming” spiega in che modo, a 
+posteriori, sia possibile individuare una vitale correzione alla tesi di Brooks. Parlando di “programmazione 
+senza ego”, Weinberg fa notare come laddove gli sviluppatori non si dimostrano territoriali rispetto al 
+proprio codice, incoraggiando altre persone a cercare bug e offrire miglioramenti, questi ultimi prendono 
+corpo molto più in fretta che altrove.  
+Forse le scelte terminologiche operate da Weinberg hanno impedito alla sua analisi di ottenere il 
+riconoscimento che merita – viene da ridere al solo pensiero di riuscire a descrivere un hacker “senza 
+ego”. Ma ritengo la sua posizione stringente più che mai.  
+La storia di Unix avrebbe dovuto prepararci per quel che stiamo imparando da Linux (e per quello che io 
+stesso ho verificato sperimentalmente su scala ridotta, copiando deliberatamente i metodi di Linus). 
+Ovvero, pur rimandando la scrittura del codice un'attività prettamente solitaria, la questione davvero 
+importante rimane la capacità di sfruttare l'attenzione e la potenza dell'intera comunità. Lo sviluppatore 
+che impiega soltanto il proprio cervello su un progetto chiuso risulterà sempre dietro allo sviluppatore che 
+sa come creare un contesto aperto, evolutivo dove sono centinaia le persone che si occupano dei 
+miglioramenti e del debugging. 
+Ma una serie di elementi hanno impedito al mondo tradizionale Unix di applicare tale approccio. Tra 
+questi, gli impedimenti legali connessi alle varie licenze, ai segreti e agli interessi commerciali. Altro 
+impedimento (in retrospettiva), il fatto che allora Internet non fosse ancora abbastanza sviluppata. 
+Prima dell'attuale Internet super-diffusa, esistevano poche comunità geograficamente compatte in cui 
+veniva incoraggiata la cultura della programmazione “senza ego” di Weinberg, dove uno sviluppatore 
+poteva facilmente attirare molti altri co-sviluppatori in gamba. Il Bell Lab, il MIT, UC Berkeley – queste le 
+dimore dell'innovazione che rimangono leggendarie e potenti ancor'oggi. 
+Linux è stato il primo progetto a proporre lo sforzo cosciente e coronato da successo verso l'utilizzo del 
+mondo intero come fucina di talenti. Non ritengo una combinazione il fatto che la gestazione di Linux sia 
+coincisa con la nascita del World Wide Web, e che Linux si sia lasciato alle spalle l'infanzia negli stessi 
+anni 1993-1994 che hanno visto il decollo dei provider locali e l'esplosione dell'interesse di massa per 
+Internet. Linus è stata la prima persona ad aver imparato come giocare secondo le nuove regole rese 
+possibili dalla diffusione di Internet. 
+Se è vero che tale diffusione si è rivelata necessaria per l'evoluzione del modello Linux, non credo però 
+possa ritenersi da sola una condizione sufficiente. Altro fattore vitale è stata l'implementazione di un certo 
+stile di leadership e di un insieme di usanze cooperative che hanno consentito agli sviluppatori di 
+coinvolgere altri co-sviluppatori e ottenere il massimo possibile dal medium stesso.  
+Ma cosa s'intende esattamente con un certo stile di leadership e quali sarebbero queste usanze 
+cooperative? Intanto, non ci si basa su relazioni di potere – e anche se tali dovessero essere, una 
+leadership fondata sulla costrizione non produrrebbe i risultati che abbiamo visto. Weinberg cita al 
+riguardo l'autobiografia dell'anarchico russo del XIX secolo Pyotr Alexeyvich Kropotkin, “Memorie di un 
+rivoluzionario”: 
+“Essendo cresciuto in una famiglia che aveva dei servitori, sono entrato nella vita attiva, al pari di tutti i 
+giovani della mia epoca, con un notevole carico di confidenza nella necessità di comandare, impartire 
+ordini, rimproverare, punire. Ma quando, ancora giovane, dovetti gestire degli affari seri e avere a che 
+fare con uomini [liberi], quando ogni errore avrebbe portato da solo a pesanti conseguenze, iniziai ad 
+ apprezzare la differenza tra l'agire basato sul principio del comando e della disciplina e l'agire basato sul 
+principio della comprensione condivisa. Il primo funziona mirabilmente in una parata militare, ma non ha 
+valore alcuno allorché si tratta della vita reale, dove ogni obiettivo può essere raggiunto soltanto tramite i 
+duri sforzi di molte volontà convergenti.” 
+È precisamente i “duri sforzi di molte volontà convergenti” sono quel che un progetto come Linux richiede 
+– e il “principio del comando” è veramente impossibile da praticare tra i volontari di quel paradiso 
+anarchico chiamato Internet. Per operare e competere con efficacia, ogni hacker che voglia guidare 
+progetti collettivi deve imparare come creare e dare energia a reali comunità d'interesse secondo le 
+modalità vagamente suggerite dal “principio della comprensione” citato da Kropotkin. Deve imparare ad 
+usare la Legge di Linus. 
+Più sopra mi sono riferito all'effetto Delfi come possibile spiegazione della Legge di Linus. Ma si 
+potrebbero anche fare analogie forse più calzanti con i sistemi d'adattamento delle scienze biologiche ed 
+economiche. Sotto molti aspetti il mondo Linux si comporta come un “free market” oppure come un 
+sistema ecologico, una serie di agenti indipendenti che cercando di massimizzare quell'utilitarismo che 
+nel processo va producendo un ordine spontaneo e in grado di auto-correggersi, più elaborato ed 
+efficiente di quanto avrebbe potuto raggiungere qualsiasi pianificazione centralizzata. È dunque questo il 
+luogo dove cercare il “principio della comprensione”. 
+La “funzione utilitaristica” che gli hacker di Linux vanno massimizzando non è economica in senso 
+classico, quanto piuttosto espressione dell'intangibile, egoistica reputazione e soddisfazione che si 
+guadagna tra gli altri hackers. (La loro motivazione potrebbe essere definita “altruista”, ma ciò 
+significherebbe ignorare il fatto che a ben vedere l'altruismo stesso altro non è che una forma di 
+soddisfazione egoistica). In realtà le culture del lavoro volontario che funzionano in tal modo non sono 
+così rare; un'altra cui ho preso parte a lungo è quella dei fan della fantascienza, che al contrario del giro 
+hacker riconosce esplicitamente come motore propulsore dietro tale attività volontaria proprio il 
+cosiddetto “egoboo” (l'esaltazione della reputazione individuale tra gli altri fan).  
+Linus, posizionandosi con successo come filtro di un progetto nel quale il lavoro è in gran parte svolto da 
+altri, e alimentando interesse nel progetto stesso finché non arriva ad auto-alimentarsi, ha dimostrato di 
+aver acutamente fatto proprio il “principio della comprensione condivisa” di Kropotkin. Questa visione 
+quasi-economica del mondo Linux ci consente di vedere come applicare tale comprensione. 
+È possibile ritenere il metodo di Linus c
+ome un modo per creare un mercato efficiente all'interno 
+dell'“egoboo” – per collegare nel modo più sicuro possibile l'egoismo dei singoli hacker con quegli 
+obiettivi difficili che possono essere raggiunti soltanto grazie alla concreta cooperazione collettiva. Con il 
+progetto fetchmail ho dimostrato (pur se su scala più ridotta) che è possibile duplicarne il metodo 
+ottenendo buoni risultati. Forse l'ho perfino messo in atto un po' più coscientemente e sistematicamente 
+di quanto non abbia fatto Linus.  
+Molte persone (soprattutto quanti politicamente diffidano del “free market”) immaginavano che una 
+cultura di egoisti auto-referenziale si rivelasse frammentaria, territoriale, sprecona, segreta, ostile. Ma 
+tale aspettativa viene chiaramente confutata (per fornire un solo esempio) dalla notevole varietà, qualità 
+e profondità della documentazione relativa a Linux. Se è un dato di fatto che i programmatori odiano 
+lavorare sulla documentazione, com'è allora che gli hacker di Linux ne producono di così copiosa? 
+Evidentemente il “free market dell'egoboo” di Linux funziona meglio nella produzione di comportamenti 
+virtuosi, diretti verso gli altri, rispetto a quei negozi dei produttori di software commerciale che si 
+occupano della documentazione, avendo alle spalle massicci finanziamenti.  
+Sia il progetto di fetchmail che del kernel di Linux dimostrano come, dando la giusta ricompensa all'ego di 
+molti altri hacker, un bravo sviluppatore/coordinatore possa utilizzare Internet per catturare i vantaggi 
+dell'avere a disposizione molti co-sviluppatori senza che il progetto si frantumi in una confusione caotica. 
+Ecco quindi la mia controproposta alla Legge di Brooks:  
+ 19: Stabilito che il coordinatore dello sviluppo abbia a disposizione un medium almeno altrettanto 
+affidabile di Internet, e che sappia come svolgere il ruolo di leader senza costrizione, molte teste 
+funzionano inevitabilmente meglio di una sola. 
+Penso che il futuro del software open source apparterrà sempre più alle persone che sanno come 
+giocare al gioco di Linus, persone che si lasceranno alle spalle la cattedrale per entrare nel bazaar. Ciò 
+non significa che non saranno più importanti le visioni e l'intelligenza individuali; credo piuttosto che la 
+punta avanzata del software open source apparterrà a quanti sapranno muovere da visioni e intelligenza 
+individuali per poi amplificarle tramite l'effettiva costruzione di comunità volontarie d'interesse.  
+E forse ciò vale non soltanto per il futuro del software open source. Nessuno sviluppatore in “closed-
+source” potrà mai pareggiare la fucina di talenti che la comunità Linux è in grado di riunire per affrontare 
+un problema. Sono davvero in pochi a potersi permettere di assumere le oltre duecento persone che 
+hanno contribuito a fetchmail!  
+Forse alla fine la cultura dell'open source trionferà non perchè la cooperazione sia moralmente giusta o 
+perché il software “costretto” sia moralmente sbagliato (dando per scontato che si creda a quest'ultima 
+affermazione, cosa che né io né Linus facciamo), ma semplicemente perché il mondo “closed-source” 
+non è in grado di vincere la corsa agli armamenti dell'evoluzione contro quelle comunità open source 
+capaci di affrontare un problema con tempi e capacità superiori di diversi ordini di grandezza. 
+11. Ringraziamenti 
+Questo scritto è stato migliorato grazie alle conversazioni avute con molte persone che hanno contribuito 
+a trovarne i bug. Ringrazio in modo particolare Jeff Dutky , che mi ha suggerito la formulazione “il 
+debugging è parallelizzabile” e che mi ha aiutato a svilupparne le analisi conseguenti. Grazie anche a 
+Nancy Lebovitz per avermi suggerito di emulare Weinberg citando Kropotkin. Critiche costruttive sono 
+venute anche da Joan Eslinger e Marty Franz della lista General Technics. Sono grato ai membri del 
+PLUG, Philadelphia Linux User's Group, per essersi prestati come primo test pubblico per la versione 
+iniziale di questo testo. Infine, i commenti iniziali di Linus Torvalds sono stati di grande aiuto e il suo 
+sostegno molto incoraggiante. 
+12. Letture consigliate 
+Ho citato diversi passaggi dal classico di Frederick P. Brooks “The Mythical Man-Month” perché, in molti 
+sensi, le sue introspezioni meritano ulteriori riflessioni. Raccomando di cuore l'edizione pubblicata in 
+occasione del 25° Anniversario da Addison-Wesley (ISBN 0
+-201-83595-9), che contiene anche il suo 
+saggio del 1986 “No Silver Bullet”.  
+Questa nuova edizione contiene un'importante retrospettiva dei 20 anni successivi in cui Brooks ammette 
+schiettamente come alcuni giudizi espressi nel testo originale non abbiano sostenuto la prova del tempo. 
+Ho letto la retrospettiva dopo aver sostanzialmente completato questo scritto, e sono rimasto sorpreso 
+nello scoprire che Brooks attribuisse pratiche da quasi-bazaar a Microsoft! (In realtà, però, si è poi visto 
+come tale attribuzione fosse erronea. Nel 1998 abbiamo appreso dagli Halloween Documents come la 
+comunità interna dei programmatori di Microsoft risulti pesantemente balcanizzata, senz'alcuna 
+possibilità per quel tipo di accesso generale ai sorgenti tipico dello stile bazaar).  
+“The Psychology Of Computer Programming” di Gerald M. Weinberg (New York, Van Nostrand Reinhold 
+1971) presenta il concetto, malamente etichettato, di “programmazione senza ego.” Pur essendo l'autore 
+nient'affatto tra i primi a rendersi conto della futilità del “principio del comando”, probabilmente fu il primo 
+a riconoscere e sostenere tale punto in particolare connessione con lo sviluppo del software. 
+Richard P. Gabriel, occupandosi della cultura Unix dell'era pre-Linux, sosteneva con riluttanza la 
+superiorità di un modello quasi-bazaar nel suo saggio del 1989: “Lisp: Good News, Bad News, and How 
+ To Win Big”. Anche se per molti versi un po' datato, il testo è ancora giustamente celebrato dai fan del 
+Lisp (incluso il sottoscritto). Qualcuno mi ha ricordato che la sezione intitolata “Worse Is Better” si 
+propone quasi come un'anticipazione di Linux. L'articolo è disponibile sul World Wide Web: 
+http://www.naggum.no/worse-is-better.html.  
+“Peopleware: Productive Projects and Teams” di De Marco e Lister (New York; Dorset House, 1987; 
+ISBN 0-932633-05-6) è una gemma sottovalutata che mi ha fatto piacere veder citata nella retrospettiva 
+di Fred Brooks. Anche se poco di quanto scrivono gli autori può applicarsi direttamente alle comunità 
+Linux o open source, le loro riflessioni sulle condizioni necessarie per un lavoro creativo sono acute e 
+valide per chiunque volesse provare ad applicare alcune delle virtù del modello bazaar in un contesto 
+commerciale.  
+Devo infine ammettere d'aver inizialmente intitolato questo scritto “La cattedrale e l'agorà”, essendo 
+quest'ultimo il termine greco per indicare un mercato all'aperto o un luogo d'incontro pubblico. Ciò per 
+l'influenza dei saggi embrionali di Mark Miller e Eric Drexler “Agoric systems” in cui venivano descritte le 
+proprietà emergenti dell'ecologia computazionale di tipo quasi-commerciale. Tali scritti mi hanno 
+preparato a riflettere con chiarezza sugli analoghi fenomeni nell'ambito della cultura open source quando 
+Linux mi ci ha fatto sbattere il muso cinque anni dopo. Questi scritti sono reperibili sul Web: 
+http://www.agorics.com/agorpapers.html.  
+13. Epilogo: Netscape si unisce al bazaar! 
+È proprio strano rendersi conto di aiutare lo sviluppo della storia...  
+Il 22 gennaio 1998, circa sette mesi dopo la prima pubblicazione di questo scritto, Netscape 
+Communications, Inc. ha annunciato la diffusione pubblica dei codici sorgenti di Netscape 
+Communicator. Fino al momento dell'annuncio, non avevo alcuna idea che ciò sarebbe mai potuto 
+accadere. 
+Subito dopo l'annuncio, Eric Hahn, Executive Vice President e Chief Technology Officer di Netscape, mi 
+ha inviato questa breve email: “A nome di tutti noi di Netscape, voglio ringraziarti per averci aiutato 
+innanzitutto a compiere questo passo. Il tuo pensiero e i tuoi scritti sono stati di fondamentale ispirazione 
+per la nostra decisione.” 
+La settimana successiva (4 Febbraio 1998), sono arrivato in aereo nella Silicon Valley su invito di 
+Netscape per partecipare a una giornata di incontri sulle strategie future con alcuni dei loro dirigenti 
+esecutivi e il personale tecnico. Abbiamo progettato insieme la strategia e la licenza per la release del 
+codice di Netscape, oltre ad aver buttato giù ulteriori piani che speriamo alla fine possano avere un 
+impatto positivo e profondo sulla comunità open source. Al momento in cui scrivo, è troppo presto per 
+entrare nello specifico; ma entro qualche settimana dovrebbero essere noti maggiori dettagli. 
+Netscape sta per fornirci un test su larga scala e assai concreto del modello bazaar all'interno del mondo 
+commerciale. La cultura dell'open source si trova di fronte a un pericolo; se l'operazione di Netscape non 
+dovesse funzionare, il concetto stesso di open source potrebbe risultarne così screditato che il mondo 
+commerciale non gli si avvicinerà per un'altra decade.  
+D'altra parte, però, si tratta di una spettacolare opportunità. L'iniziale reazione a tale mossa in quel di 
+Wall Street e altrove è stata cautamente positiva. Ci è stata data la possibilità di provare cosa sappiamo 
+fare. Se grazie a questa mossa Netscape saprà riguadagnare una sostanziale quota di mercato, ciò 
+potrebbe davvero innescare la rivoluzione attesa da lungo tempo nell'industria del software.  
+L'anno prossimo sarà un anno molto istruttivo e interessante.  
+ 14. Cronologia delle versioni e delle modifiche 
+$Id: cathedral-bazaar.sgml,v 1.42 22/11/1998 04:01:20 esr Exp $  
+Presentazione della 1.16 al Linux Kongress, 21 Maggio 1997.  
+Bibliografia aggiunta il 7 Luglio 1997 nella 1.20.  
+Aggiunto l'aneddoto sulla Perl Conference il 18 Novembre 1997 nella 1.27.  
+Modificato “free software” in “open source” il 9 Febbraio 1998 nella 1.29.  
+Aggiunto “Epilogo: Netscape si unisce al bazaar!” il 10 Febbraio 1998 nella 1.31.  
+Eliminato il grafico di Paul Eggert sulla questione GPL-bazaar dopo vivaci discussioni con RMS il 28 
+Luglio 1998.  
+Aggiunta correzione su Brooks basata sugli Halloween Documents il 20 Novembre 1998 nella 1.40.  
+Altri livelli di revisione hanno incorporato minori aggiustamenti editoriali. 
+ 
+Traduzione italiana a cura di Bernardo Parrella berny@apogeonline.com, Giugno 1999 
+Per il testo originale inglese: http://www.tuxedo.org/~esr/writings/cathedral-bazaar/cathedral-bazaar.html 
+ 

static/data/lettere_musulmane.txt

@@ -0,0 +1,1891 @@
+ « SPIRITUALITÀ SPERIMENTALE » 
+Collana diretta da Gianpaolo Fiorentini 
+15 
+ © 1998: Promolibri Magnanelli, Torino 
+Stampa: M.S./ Litografia, Torino 
+ I N D I C E 
+Introduzione 
+9 
+Prima lettera 
+13 
+Prima risposta 
+19 
+Seconda lettera 
+23 
+Seconda risposta 
+27 
+Terza lettera 
+31 
+Terza risposta 
+35 
+Quarta lettera 
+39 
+Quarta risposta 
+42 
+Quinta lettera 
+47 
+Quinta risposta 
+50 
+Sesta lettera 
+53 
+Sesta risposta 
+56 
+Settima lettera 
+61 
+Settima risposta 
+64 
+Ottava lettera 
+67 
+Ottava risposta 
+69 
+ Nona lettera 
+15 
+Nona risposta 
+78 
+Decima lettera 
+81 
+Decima risposta 
+84 
+Undicesima lettera 
+87 
+Undicesima risposta 
+91 
+Postfazione 
+93 
+ L'Alchimia è la sorella della Profezia 
+Ja'far al-Sadiq 
+Noi siamo i Sapienti che impartiscono l'insegnamento, 
+i nostri shi'iti sono i destinatari del nostro insegnamento. 
+Il resto, ahimè, è la schiuma trascinata dal torrente. 
+'Ali ibn Abi Tàlib 
+Lieto 
+giacevo nel cuore della perla; 
+finché, sferzato dalle tempeste, 
+la vita mi agitò come un'onda. 
+Il segreto del mare 
+feci suonare con voce di tuono. 
+Come nuvola esausta sulla spiaggia 
+mi addormentai. Non mi svegliai più. 
+Rumi 
+  INTRODUZIONE 
+Questa primavera, nella mia professione 
+di no-
+taio, fui chiamato da un cliente per un problema 
+singolare. Era questi l'ultimo rappresentante 
+di 
+un'antica famiglia che possedeva ancora qualche ric-
+chezza e i cui antenati avevano svolto un ruolo 
+importante nella storia locale. Mi chiedeva di rag-
+giungerlo in una vecchia villa al di là delle colline 
+che fronteggiano la città, dove il fiume si arresta un 
+attimo a formare un piccolo lago per poi proseguire. 
+Vi viveva con una coppia di domestici lo zio, 
+uomo stravagante e solitario. Qualcuno lo ricordava 
+giovane buontempone che amava belle donne e bel 
+vivere, e vecchi amici descrivevano feste, balli e cene 
+allegre nella villa illuminata e rumorosa. Anni pri-
+ma, si raccontava, tornato da un viaggio si era rin-
+chiuso in casa, scoraggiando ogni contatto con rispo-
+ste scontrose sinché nessuno lo aveva più cercato. 
+Dopo il mio arrivo ci sedemmo in un comodo 
+salottino e il mio cliente chiamò i domestici a riferi-
+re quello che era avvenuto, mi parve però con una 
+curiosa reticenza, come per qualche fedeltà o timore. 
+ Il racconto fu breve: all'inizio di aprile il padrone 
+li aveva quasi cacciati, costretti a forza a una vacan-
+za di un mese con l'imposizione di non farsi vivi pri-
+ma della scadenza, per nessun motivo. Al ritorno 
+avevano trovato villa vuota, proprietario scomparso, 
+una lettera per loro e una per il nipote, entrambe in 
+bella vista sul tavolo di cucina. 
+Il contenuto era semplice e conciso: confermava 
+una partenza definitiva, senza indicazioni, e dava 
+brevi istruzioni con delega al nipote per la gestione 
+del patrimonio. Era per quest'ultima parte, eviden-
+temente, che era stata richiesta la mia presenza. 
+Esaminammo la villa. Nello studio un caminetto 
+colmo di cenere e frammenti di carta testimoniava che 
+si erano bruciati molti documenti. Di un grosso qua-
+derno era rimasta parte della copertina mezza con-
+sumata: era ancora possibile leggere «Diar.. d.. lab..». 
+Girando per casa in cerca di indizi 
+scendemmo 
+nel seminterrato. Qui, con mio grande stupore, sta-
+va un vasto laboratorio ben attrezzato per esperi-
+menti di chimica e metallurgia: forni, vecchi alam-
+bicchi, pestelli e mortai di tutte le dimensioni, cro-
+gioli usati in gran quantità. Nessun materiale. Sem-
+brava ci si fosse dati gran pena per ripulire tutto. 
+Solo, in bella vista su un tavolo, uno splendido lin-
+gottino giallo che un orefice confermò poi essere di 
+oro purissimo. 
+ Una porta laterale conduceva in uno studio con 
+pareti ricolme di libri. Sulla scrivania, legate da un 
+nastro verde, delle lettere con un biglietto enigma-
+tico che diceva: «Queste si possono 
+mostrare». 
+Concluse le incombenze 
+legali il giovane 
+volle 
+affidare a me le lettere perché le esaminassi e ne 
+decidessi la sorte. In effetti sapeva che amavo studi 
+esoterici, e pensava che ne potessi dare un giudizio. 
+Dopo una prima scorsa, fu evidente che non rap-
+presentavano se non la minima parte di uno scam-
+bio epistolare molto più ampio, certamente più det-
+tagliato. Era stato cancellato con cura tutto ciò che 
+poteva indicare nome e luogo dell'interlocutore mi-
+sterioso, con tutte le date. 
+Ero in buona amicizia con uno studioso di isla-
+mismo, ne chiesi il parere. Riporto qui il commento 
+sintetico con cui le restituì: 
+Caro amico, 
+si tratta certamente di una documentazione notevole. Il 
+maestro dell'Islam è molto probabilmente un sufi di 
+scuola shi'ita. Lo dimostra certo linguaggio: per esem-
+pio «situazione» e «stato» così come sono usati nella 
+sesta risposta corrispondono sicuramente a maqàm e a 
+hai, e sono termini tecnici della letteratura sufi. Mentre 
+l'accenno all'amicizia con Dio, la walàyat, è tipica del 
+pensiero shi'ita. 
+Le ritengo di grande interesse. 
+ Perciò le ho tradotte, erano in inglese, cercando 
+di comprendere 
+il senso delle frasi talvolta molto 
+oscure, e lasciandole nello stesso ordine in cui sta-
+vano, sino all'ultima brevissima comunicazione. Le 
+ho poi sottoposte a un editore, che ha accettato di 
+pubblicarle. 
+Così facendo spero di aver bene interpretato la 
+volontà di chi me le ha inconsapevolmente 
+affidate, 
+dovunque si trovi ora. 
+ PRIMA LETTERA 
+Caro Maestro, 
+da voi il silenzio, e nel silenzio la pace. Qui tut-
+to è rumore, e nel rumore la paura. Presso di voi 
+il frutto, qui nulla se non la vita elementare, con 
+tutte le sue fatiche. 
+Che vi posso dire di più. Volevate conoscere il 
+mio mondo e i miei problemi. Guardate un for-
+micaio: l'attività è frenetica, furia cieca della natu-
+ra che spinge a crescere, procreare, senza altro 
+scopo che esistere. 
+Ascoltate un alveare: operosità continua in un 
+ronzio ininterrotto, senza un attimo di quiete. 
+Mi dite che spesso siete nel deserto a meditare 
+e studiare: immaginate un mondo senza deserti, 
+dove la solitudine sia un dono impossibile, il silen-
+zio un ricordo appannato e la vita un affannarsi 
+insensato, una corsa senza punto di arrivo, fatta a 
+spintoni e gomitate per conquistare un premio che 
+non esiste. 
+Mi chiedete cosa sto cercando: userò parole 
+non mie. Da poco è morto un Papa, e ne hanno 
+ cjpi t
+i
+c
+q
+u
+c
+u
+i
+f
+f
+c
+i
+i
+i
+n
+.
+p
+f
+i
+r
+d
+b
+t
+é b
+K
+u
+i
+v
+r
+m
+r
+a crac. 
+_ 
+q
+> j
+q
+u
+j
+n
+o
+n
+c 
+flmmnispwbibm 
+b
+j
+n
+u
+f
+c
+e
+n
+»
+. t
+u 
+|j>ini0l(U9 
+Damasco, mitica città di studiosi e traduttori, 
+in un'incisione occidentale. 
+ eletto un altro. Il nuovo è un uomo dolcissimo, 
+che non pare di questo mondo, dall'aria svagata 
+come si trovasse per caso su una sedia un po' osti-
+le, un po' estranea. Pochi giorni fa diceva che se 
+anche siamo mescolati alla confusione e al rumo-
+re, dobbiamo affermare: "Oltre un certo punto voi 
+non esistete per me, ed io mi ritiro in me, nel mio 
+giardino di quiete e di delizie, unito al mio Dio, in 
+pace". Ricordava un facchino che aveva visto dor-
+mire tranquillo in una stazione, circondato dal 
+baccano di treni e uomini e bagagli. Questa, ha 
+detto, è la Grande Disciplina, da non confondere 
+con la Piccola Disciplina che consiste solo nel 
+seguire le regole esteriori cui tutti ci dobbiamo 
+adattare. 
+Vorrei conoscere questa Grande Disciplina. 
+Vorrei la pace di quel facchino, qualunque cosa 
+essa sia. 
+Così, caro Maestro, ho scoperto l'Alchimia, di 
+cui tanto vi ho parlato, il motivo per cui chiedo 
+aiuto e guida. 
+Mi chiedete come vi sono giunto. L'ho incon-
+trata in un libro, come capita sempre, come è ine-
+vitabile qui, in Occidente, dove i Templi non esi-
+stono più, dove i Maestri stanno silenti e nascosti, 
+dove restano solo libri di pietra e carta per legge-
+re di antiche sapienze. 
+ L'ho letto, il libro di cui vi parlo, in un momen-
+to di disperazione, di rifiuto totale per questo 
+mondo, per il suo rumore, per il suo nulla fatico-
+sissimo, per la paura che lo avvolge come una cap-
+pa di tempesta imminente. Mi sentivo come dice 
+un filosofo che voi non conoscete, che non appar-
+tiene e non potrebbe appartenere al deserto. Mi 
+sentivo «come una puttana che vaga in una città 
+senza marciapiedi». A mezzo tra sofferenza e 
+oblio, drogato dallo stesso esistere di questo ru-
+more senza fine. 
+Così è incominciata la mia ricerca. Per caso. Ho 
+letto un libro e mi sono innamorato del silenzio 
+che vi abitava. Ho avuto l'intuizione di un luogo di 
+pace, un ricordo, una nostalgia. Un richiamo al 
+deserto, al secco, non arido, deserto che non ho 
+mai conosciuto. 
+Ho letto, e non ho capito. Ho sentito qualcosa 
+che si agitava, l'embrione informe, minuscolo, 
+impreciso, di una nascita possibile. Il nucleo invi-
+sibile di una parola silenziosa, splendente. 
+Non so dirvi di più. Mi pare di aver capito, que-
+sto sì, che nella materia, proprio in quella fisicità 
+che sembra orrenda, spiacevole, ignobile, proprio 
+in quella stia in qualche modo la chiave per qual-
+cosa che potrei chiamare il divino, se solo avessi 
+ancora una religione. 
+ Anche di questa mi avete chiesto. Non saprei 
+cosa rispondervi. Noterò solo un segno. Un tem-
+po i nostri sacerdoti officiavano guardando ad 
+Oriente, alla vita e al suo sorgere. Oggi guardano 
+ad Occidente, alla morte e al suo approssimarsi. 
+Prima volgevano le spalle all'uomo e guardavano 
+a Dio. Oggi volgono le spalle a Dio e guardano 
+l'uomo. 
+Mi sembra semplice simbolo di un mondo, non 
+morente, già morto. La convulsa attività che mani-
+festa non proviene da eccesso di vita, ma da de-
+composizione cadaverica, quando nella corruzione 
+corporea tutto si muove, vermicola, gonfia, erutta, 
+emana. 
+L'anima è persa, fuggita con la vita e il respiro. 
+Resta ancora un oscuro fervore psichico ad emet-
+tere le fetide esalazioni che i demoni amano e da 
+cui sono abbondantemente nutriti. 
+Sembra un'opera alchemica in atto: corruptio 
+unius est generatio alterius, dicevano i vecchi mae-
+stri. Dunque inutile piangere su ciò che è finito, 
+aspettiamo con curiosità e speranza quello che 
+verrà. In effetti la morte, qui lo abbiamo dimenti-
+cato, è un momento ineluttabile di questa manife-
+stazione, e non è detto sia sempre un male... 
+Proprio qui, comunque, devo incominciare la 
+mia ricerca, e proprio qui, in questo stato sepol-
+ crale, occorre una guida perché i primi passi 
+abbiano la corretta direzione. Qualche secolo fa 
+un alchimista ha scritto: 
+La nostra pratica in effetti è un cammino nelle sabbie, 
+dove ci si deve guidare con la stella del Nord, piuttosto 
+che con le orme che vi si vedono impresse. La confu-
+sione delle tracce, che un numero quasi infinito di per-
+sone vi ha lasciato, è così grande, e vi si trovano così 
+tanti sentieri diversi, che conducono quasi tutti in 
+orrendi deserti, che è quasi impossibile non deviare 
+dalla vera via, che solo i saggi favoriti dal Cielo hanno 
+saputo fortunatamente scoprire, e riconoscere. 
+Tra queste sabbie, in questi deserti disperati, 
+così diversi dai vostri, non cerco i misteri delle 
+operazioni, gli arcani segreti dell'Arte. Cerco l'in-
+dicazione primordiale, la parola iniziale, la traccia 
+del primo passo. 
+Rispettosamente. 
+ PRIMA RISPOSTA 
+Caro studioso, 
+Dio dice nel suo santo Qur'an: 
+Il tuo Signore trasse dai lombi dei figli di Adamo i loro 
+discendenti e li fece testimoniare verso se stessi. "Non 
+sono il vostro Signore?". "Sì, l'attestiamo", risposero. 
+Questo perché non possiate dire il giorno della Resur-
+rezione: "Noi non ne sapevamo nulla". O perché non 
+diciate: "I nostri padri prima di noi hanno accolto falsi 
+dei. Noi siamo i loro discendenti. Ci vuoi dunque far 
+perire per le azioni di uomini vani?" (Sura VII, 171-
+172, Al A'ràj., il Purgatorio). 
+Dio si fa conoscere per mezzo della sua parola, 
+e ogni versetto è una manifestazione. 
+La parola ha il suo limite nella manifestazione, 
+e la manifestazione è la parola che sale sino al vol-
+to di chi la pronuncia. 
+Dio ha posto la sua parola sui discendenti di 
+Adamo quando erano ancora atomi. Ha detto: 
+"Non sono il vostro Signore?" ed essi sentirono 
+chiaramente. Perciò anche gli atomi hanno fede e 
+pregano. I loro movimenti sono un prostrarsi in 
+ atteggiamento di umiltà, ed essi lo fanno anche 
+quando non sono ancora corpi completi. 
+Questa è la fede innata, quella per cui gli atomi 
+si muovono intimamente. 
+Dopo di questo, quando si formano i corpi, non 
+esiste più sapienza ma esiste il potere. Allora la 
+parola e la visione sono velate al di là del mondo 
+della non visione, e i movimenti intimi degli atomi 
+si colmano di oscurità. 
+Il cammino mistico si muove in senso contrario 
+a questo. Chi è su questo cammino si purifica e 
+rasserena per mantenere in se stesso il mondo del 
+potere fuori dal mondo della sapienza, per scopri-
+re la visione penetrante della sapienza e poter udi-
+re: "Non sono io il vostro Signore?". Allora questa 
+parola si rivela e supera nella sua unicità le fasi di 
+oscurità con la luce della visione. 
+Io ho manifestato ogni cosa in modo che essa mi 
+veli e non guidi sino a me. 
+Unirsi a me è la cosa più elevata che io abbia 
+manifestato, ma l'unirsi a me è un velo. 
+Quando io appaio, tu non vedi nulla. La parola 
+in alto è un limite per ciò che sta in basso, ma non 
+c'è limite per ciò che sta in alto. 
+Io sono la causa dell'apparizione 
+di ciò che si 
+manifesta, e sono la causa per cui appare in ciò che 
+io voglio che appaia. 
+ M
+i r' rff i-mK<ÌKr.mistMiK?«»Vi .uöi 
+fp 
+tt6$tmtintl 
+fSnC-'iiiW.K-
+(¿Htif^wifi WI»«M(K>Í«>Í6 »tnuCtVftjj 
+ilfit 
+'f¿jín«£jtí-{ip<i(tt <tß ^iwSif 
+(DTUVikiit«/-
+^"v^c'S»»«? tlviinnìÀ qtui. 
+A 
+(Sunt 
+^ÜWIKhiiSltmill 
+t- 
+p
+C
+i 
+^ t i 
+Ht/(] 'ft (tfc 
+wmWiV ptiUiftt?1 
+f<r pnfbm www 
+j
+» H
+K
+T
+U
+>
+: f Sx* x'im/Dtíitinéín'á/^ii) 
+>
+.
+• i',s, 43 q
+w
+\
+l
+m f^.ti ßit««ir ntPotito{v^:/f. 
+I v
+-
+i
+l «.Unfit nm ))Utr .{crsyityv* 
+qMítil- >
+•
+»
+« 
+ttj)x;tm*/VI.iMifîi(>Mpit« 
+ Ciò che è compiuto è compiuto, ciò che ho stabi-
+lito è stabilito, ciò che è stabilito è compiuto in quel-
+lo che tutto abbraccia. 
+Caro studioso, ascolta le lingue dei mondi nelle 
+manifestazioni spirituali. Essi dicono: "Dio! Dio!". 
+Ed egli dice: "Non li sente chi sta in loro, o chi cer-
+ca in loro delle testimonianze". 
+Caro studioso, se tu aderirai a ciò che ti è stato 
+assegnato tra questi due mondi, allora sarai un 
+amico di Dio. 
+La pace sia con te. 
+ SECONDA LETTERA 
+Caro Maestro, 
+credo che si diventi alchimisti come ci si in-
+namora: misteriosamente e incomprensibilmente. 
+All'inizio, una predisposizione, un essere già inna-
+morati senza oggetto d'amore, inconsapevolmente: 
+è un sentimento che si unisce a disperazione quie-
+ta, non malvagia o triste, piuttosto melanconica. 
+Nasce dalla nostalgia di qualcosa di perso, di ab-
+bandonato, di un posto che ci apparteneva, che 
+non sappiamo più trovare. Il sentimento di chi ha 
+perso la propria patria e non sa come raggiungerla. 
+Nel tempo mi sono chiesto se non sia questo il 
+fondamento dell'essere ebrei: la ricerca di una 
+Terra Promessa, che non si traduce mai in realtà, 
+che rende stranieri dovunque si sia. Nei secoli 
+qualcuno ha cercato di realizzare il sogno: credo 
+che non vi sia peggiore illusione di quella di voler 
+tradurre in pratica, di voler corporificare, un sim-
+bolo che per sua natura non è di questo mondo. 
+Ogni alchimista è un ebreo della diaspora: que-
+sto significa la frase, riportata da Zosimo, di Maria 
+ Profetessa: "Stai lontano dall'Arte, tu che non sei 
+della nostra razza, perché tu non sei del sangue di 
+Abramo!" 
+Dobbiamo essere del sangue di Abramo, se vo-
+gliamo perseguire questa via, se pensiamo di esser-
+vi predestinati o chiamati. Perché di vocazione si 
+tratta, che deve nascere da una mancanza, nostal-
+gia della patria smarrita. 
+La patria diventa facilmente donna. La nostal-
+gia si traduce in amore. 
+Trovo questo richiamo all'amore in tutti i 
+Maestri dell'Arte, sin dal nome che danno a se 
+stessi e ai loro fratelli: Innamorati della 
+Dottrina. 
+La Dottrina, la Sapienza, la Sofia degli gnostici, 
+non qualcosa di intellettuale, razionale, nel senso 
+comune della parola. La Dottrina come vita e 
+gioia, felicità ritrovata, dolcezza e riposo, virtù e 
+potenza, patria e donna amata. La Dottrina come 
+bellezza inimmaginabile. 
+Tutti sono innamorati. Tutti i poeti iniziati lo 
+raccontano. Innamoramento che sorge in una sta-
+gione singolare, in uno stesso mese, quello di No-
+stra Signora, di Maria, Maia, la madre di Mercurio. 
+Non ci si innamora in un momento qualsiasi: 
+Ce fut au temps de mois de May 
+qu'on doibt foui'r dueil et esmay 
+ qu'i'entray dedans un vergier 
+dont Zephirus fut iardinier. 
+E Dante, l'innamorato per eccellenza dell'Occi-
+dente: 
+Avvenne una die che, sedendo io pensoso in alcuna 
+parte, ed io mi sentio cominciare un tremuoto nel cuo-
+re, così come se io fosse stato presente a questa donna. 
+Allora dico che mi giunse una immaginazione di Amore 
+E poco dopo io vidi venire una gentile donna, la quale 
+era di famosa bieltade e [...] per la sua bieltade impo-
+sto l'era nome Primavera; e così era chiamata. 
+In primavera, come dice 
+...li Romans de la Rose 
+ou l'art d'Amors est toute enclose 
+che racconta: 
+En may estions, si songoie 
+ou temps amorous plain de joie... 
+Si vaneggia? Ricordo una fiaba, sempre la stes-
+sa. Un cavaliere, l'eroe, deve affrontare un orren-
+do drago. Lo uccide dopo infinite peripezie e peri-
+coli. Una fanciulla bellissima e dolcissima è libera-
+ta, diventa il suo premio onorevole e meritato. 
+Quella fanciulla, si narra, solo i veri Filosofi pos-
+ sono vedere e contemplare nuda in tutta la sua 
+splendida venustà, senza morire o essere inceneri-
+ti dalla Belle Dame sans mercy. E ancora Dante a 
+dirlo concisamente: 
+e qual soffrisse di starla a vedere 
+diverria nobil cosa, o si morria. 
+Tutto questo suona un po' retorico e troppo 
+intelligente. Eppure dal Cantico dei Cantici ai ro-
+manzi del Graal, dai miti greci a Goethe, dalle me-
+lanconiche pagine del triste cavaliere della Mancia 
+ai momenti più ispirati di Melville, tutti cantano 
+questo amore, questa nostalgia, e tutti dicono che 
+soltanto chi giunge alla Terra Promessa sta in pace 
+ed è felice. 
+Io cerco l'oggetto del mio amore perché questa 
+passione, che ora è sofferenza, disperazione, logo-
+rio della mente e dell'anima, si quieti. 
+Rispettosamente. 
+ SECONDA RISPOSTA 
+Caro studioso, 
+l'amore di cui tu parli, è innanzitutto amore di 
+Dio, per Dio. La donna è la sua Sapienza e la 
+Maestà del suo Trono. Rivolgiti a lui e digli: "O 
+Signore, fa' che il mio amore per te sia più profon-
+do del mio amore per me stesso, per il mio udito, 
+per la mia vista, per la mia gente, per i miei averi". 
+Il puro speciale amore di Dio è l'amore che ine-
+bria lo spirito. E una scelta divina per colui che 
+adora, perché è un dono di Dio e non è amore di 
+un'entità. Questo amore viene con gli impulsi del-
+la fede: è divino amore che ricambia la vicinanza. 
+L'adoratore si prostra sull'orlo dell'abito della 
+maestà divina, come in uno stato sublime, e que-
+sto può avvenire soltanto per coloro il cui sé sale 
+nella luce dello spirito, perché la sua ebbrezza è 
+sopraffacente e la forza di inclinazione altamente 
+efficace. 
+Quando l'adoratore ridiventa sobrio, torna al 
+suo stato di bisogno e alla privazione del fidanza-
+mento. Ma quando si sono completate le facoltà 
+ che vengono dalla vicinanza con l'emancipazione 
+dello spirito, per mezzo della completezza della pri-
+vazione, che non permette più che si parli, quando 
+la porzione della vicinanza si accumula e mantiene 
+il senso di fidanzamento del sé, allora questo è un 
+dono, e si può dire: "Oh Signore Iddio!". 
+Allora ascolta: 
+Nulla è più vicino a me di qualunque altra cosa, e 
+nulla è più lontano da me di ogni altra cosa ad ecce-
+zione di quanto lo stabilisco in vicinanza e lonta-
+nanza. 
+La lontananza è resa nota dalla vicinanza, e la 
+vicinanza è resa nota dall'esperienza spirituale: io 
+sono colui che la vicinanza non cerca, e che l'espe-
+rienza spirituale non raggiunge. 
+Il minimo delle scienze della mia vicinanza è che 
+tu dovresti vedere gli effetti del mio sguardo in ogni 
+cosa, e che esso dovrebbe prevalere sopra la tua gno-
+si di esso. 
+Tu non conosci la vicinanza, e tu non conosci la 
+mia vicinanza e non conosci la mia condizione come 
+io la conosco. 
+Io sono il vicino, non come una cosa è vicina ad 
+un'altra: io sono il lontano, ma non come una cosa 
+è lontana da un'altra. 
+La tua vicinanza non è la tua lontananza e la tua 
+ lontananza non è la tua vicinanza: io sono il vicino 
+e il lontano, con una vicinanza che è lontananza e 
+una lontananza che è vicinanza. 
+La vicinanza che tu conosci è misurabile, è una 
+distanza: e la lontananza che tu conosci è misurabi-
+le, è una distanza. 
+Io sono il vicino e il lontano senza misura. 
+Io sono più vicino alla lingua del suo discorso 
+quando parla. 
+Chi mi contempla non si raccoglie in meditazio-
+ne e chi medita su di me non contempla. Come per 
+il contemplativo che medita, se ciò che contempla 
+non è realtà, egli è velato da ciò su cui medita. Non 
+tutti i meditativi sono dei contemplativi: ma ogni 
+contemplativo è un meditativo. 
+10 rivelo me stesso e tu non mi conosci: questa è 
+lontananza. 
+11 tuo cuore mi ha visto e non mi ha visto: questa 
+è lontananza. 
+Tu mi trovi e non mi trovi: questa è lontananza. 
+Tu mi descrivi e non mi cogli dalla descrizione: 
+questa è lontananza. 
+Tu ascolti i miei discorsi come se venissero dal 
+tuo cuore, mentre vengono da me: questa è lonta-
+nanza. 
+Sebbene tu veda te stesso, io sono più vicino a te 
+della tua visione di te stesso: questa è lontananza. 
+ Caro studioso, questo amore si manifesta nelle 
+tenebre, ed esce come una luce dall'oscurità. Dal 
+nero esce il bianco splendente dell'amore divino, 
+e dall'ignoranza e dal silenzio esce la parola di vita 
+e di gnosi che tu stai cercando. Tu non devi 
+confondere, e tu devi stare attento agli inganni. 
+Ascolta il Profeta, Dio benedica il suo nome: 
+Dio è la fiaccola che illumina i cieli e la terra. La sua 
+luce assomiglia a quella che sfugge da una nicchia di 
+cristallo dove brilla una fiamma inestinguibile. Il cri-
+stallo è una stella di perle il cui splendore viene da un 
+ulivo benedetto che non è né d'Oriente né d'Occi-
+dente. Il suo olio illumina senza contatto col fuoco. Vi 
+è là luce su luce. E Dio accorda la sua Luce a chi gli 
+piace. (Sura XXIV) 
+La pace sia con te. 
+ TERZA LETTERA 
+Caro Maestro, 
+mi interrogate sugli obiettivi, tenterò una ri-
+sposta. 
+Tre doni si dice procuri la Pietra Filosofale, 
+quelli che i re Magi portarono al bambino divino, 
+Pietra vivente e miracolo celeste. 
+Per primo l'Oro, la ricchezza mondana. È l'uni-
+co descritto senza velamenti, con estrema preci-
+sione. 
+Si prende la Pietra, si aggiunge in proporzioni 
+ben determinate a oro o argento in fusione, si 
+ottiene così 'a «Polvere di Proiezione», medicina 
+capace di curare o tingere i metalli imperfetti per 
+transmutarli in preziosi. 
+Mi chiedo perché sia posto tanto in evidenza: 
+non dovrebbe interessare il filosofo. Ci si è sforza-
+ti di trovarvi un significato recondito, più nobile. 
+Quell'oro è diventato spirituale, mistico, simbolo 
+di cambiamenti umani; si è negata ogni realtà alla 
+transmutazione metallica e all'acquisto di dovizie. 
+ Curiosamente la nostra epoca, tutta tesa alla ric-
+chezza materiale e ai piaceri che questa può pro-
+curare, ama esaltare quella miseria che in pratica 
+aborre. Non fu sempre così. Guardando le grandi 
+figure bibliche: Abramo si arricchisce con modi 
+ambigui, Giacobbe inventa trucchi per farsi un 
+gregge numeroso - aveva già dato prova di abilità 
+ulissiache per conquistare la primogenitura - di 
+Salomone si esaltano ricchezza e possessi. 
+Resta comunque un dono dall'aria perversa e 
+insoddisfacente. Non credo valga tanti sforzi, ci 
+sono modi più semplici per arricchire. 
+Seconda la Mirra, «Elisir di lunga vita», l'im-
+mortalità fisica, l'eterna giovinezza al riparo da 
+ogni male. E il dono di Mefistofele, la fonte di 
+Ponce de Leon, la sorgente di ogni piacere e di 
+ogni dolcezza in vita. 
+Così sarebbe se non avesse in sé il suo veleno: 
+l'eterna vita in questo mondo. 
+Davvero questa sarebbe l'estrema beffa. Solo un 
+folle potrebbe voler restare un attimo più del do-
+vuto. Già pesa il divieto di fuggirne, certo non 
+interessa restarci. 
+Ho il dubbio che sia qualcosa di diverso, forse 
+addirittura il suo opposto simbolico, la certezza di 
+non vivere, di non vivere più, non la Medicina Uni-
+versale, ma il veleno perfetto, la perfetta morte. 
+ 4 t«. 
+' - e 
+1 
+L ^ * « ^ 
+l à i T f X H i H U o l ^ i f 
+I B A I 3 I M K - U H 5 1 V 1 
+^
+^
+¿
+¿
+^ 
+Mi*-
+Manoscritto alchemico 
+arabo. 
+ Infine l'Incenso, la completa sapienza, essere 
+come Salomone, conoscere tutti gli arcani del 
+mondo, i più reconditi recessi della Natura, i 
+misteri dell'Alto e del Basso. Questo davvero sem-
+bra il giusto obiettivo di un filosofo, di un inna-
+morato della Dottrina-, ritrovare la Parola Perduta, 
+la vera pronunzia del Nome, riscoprire la perla 
+nascosta, sembra l'unico scopo che valga. 
+Sin dalla prima operazione, perciò, la nostra 
+Magnesia deve richiamare, attrarre l'Angelo della 
+Conoscenza, perché è scritto: 
+Non è dato all'uomo che Dio gli parli altro che per una 
+comunicazione da dietro un velo, oppure gli invia un 
+Angelo. (Sura XLII, 50-51) 
+Lo spirito celeste di saggezza deve scendere 
+dall'Alto - l'incorporeo si deve corporificare - per 
+impregnare ciò che sta in Basso. Allora la nostra 
+Materia diventa Specchio della Natura e potremo 
+apprendere tutti i segreti del macrocosmo e del 
+microcosmo e gli arcani dell'umano e del divino. 
+L'obiettivo vero è la Gnosi, e il segreto del-
+l'Opera consiste in una terra benedetta, la Terra 
+Santa, che permette all'angelo della gnosi di scen-
+dere e di manifestarsi a noi per insegnarci la cono-
+scenza perfetta. 
+Rispettosamente. 
+ TERZA RISPOSTA 
+Caro studioso, 
+non dire mai che la conoscenza sta nel celestia-
+le: nessuno discende con essa. Non dire nemmeno 
+che sta nei limiti del terrestre: nessuno ascende 
+con essa. Essa sta nei cuori. 
+Chi sei tu e chi sono io? E io vedo il sole e la 
+luna, le stelle e tutte le luci. Ed egli mi disse: Non 
+rimane alcuna luce nella corrente del mio mare, che 
+tu non hai visto. 
+E ogni cosa venne a me sinché non rimase nul-
+la. E ogni cosa mi baciò tra gli occhi e si offrì ai 
+miei sensi e restò nell'ombra. 
+Ed egli mi parlò. Ed io vidi tutto di lui connes-
+so al mio abito, cioè alla mia apparenza corporea, 
+e non connesso a me. 
+Ed egli mi disse: Questo è il mio servizio. Ed il 
+mio abito si inchinò, ma io non mi inchinai. E 
+quando il mio abito si inchinò, egli mi disse: Chi 
+sono io? E il sole e la luna si oscurarono, e le stel-
+le caddero dal cielo e le luci impallidirono e le 
+tenebre coprirono ogni cosa, eccetto lui. 
+ E tutte le cose parlarono e dissero: "Dio è gran-
+dissimo". 
+E tutte le cose vennero da me, portando una 
+lancia in mano. Ed egli mi disse: Fuggi. Ed io dis-
+si: "Dove debbo fuggire?". Ed egli mi disse: Cadi 
+nelle tenebre. E mi osservò. Ed egli mi disse: 
+Non dovrai mai più osservare altri che te stesso, 
+e non dovrai mai più allontanarti dalle tenebre da 
+adesso per sempre: ma quando io ti caccerò da esse, 
+io ti mostrerò me stesso e tu mi vedrai. E quando 
+mi avrai visto sarai più lontano da me di tutti colo-
+ro che sono lontani. 
+L'etica della gente dello spirito cerca di impe-
+dire ai sé di correre dietro ciò che vogliono, ma ciò 
+non può avvenire se non per coloro che hanno 
+saputo, ascoltato e si sono dedicati al divino per 
+prendere il vero dal vero, per dire il vero e per sta-
+re in silenzio nel vero. 
+Se tu non mi vedi, non lasciare il mio nome. 
+Quando tu stai davanti a me, ogni cosa ti chiama: 
+fa' attenzione a non ascoltarla con il tuo cuore, per-
+ché se tu l'ascolti è come se le rispondessi. 
+Quando la conoscenza ti chiama, con tutte le sue 
+condizioni, al tempo della preghiera, e tu le rispon-
+di, tu sei separato da me. 
+ Quando io guardo il tuo cuore, nessun'altra cosa 
+vi entra. 
+Se tu mi vedi nel tuo cuore, sei capace di soppor-
+tarmi. 
+I miei amici sono quelli che non hanno nessuna 
+opinione 
+personale. 
+II tuo corpo dopo la morte sta nel posto del tuo 
+cuore prima della morte. 
+Quando tu stai di fronte a me, nessun altro starà 
+con te eccetto te. 
+Quando l'alterità diventa un pensiero biasimevo-
+le, Paradiso e Inferno svaniscono. 
+La pace sia con te. 
+ Il maestro e l'allievo, in un antico codice siriaco. 
+ QUARTA LETTERA 
+Caro Maestro, 
+ho letto a lungo, con attenzione, come mi avete 
+suggerito, Jàbir, quello che ho potuto trovare in 
+traduzione: II piccolo libro della Clemenza, Il libro 
+della Misericordia, Il libro dei Settanta, Il libro del-
+la Concentrazione, Il libro del fuoco della Pietra, Il 
+libro delle Bilance - su questo vorrei fare un di-
+scorso a parte. 
+Per quanto riguarda il problema su cui mi inter-
+rogo, ho trovato queste affermazioni: 
+Se tu, uomo intelligente, esamini tutte queste cose, 
+vedrai che lo scopo da raggiungere non si ottiene se non 
+con l'aiuto di cose diverse, cioè delle quattro nature. 
+Occorrono forze diverse, spirituali e corporali. Queste 
+forze debbono essere convergenti e non divergenti, 
+come forma e come colore. 
+Le forze spirituali e corporali devono avere delle affi-
+nità tra loro, in modo da potersi aiutare reciprocamen-
+te. Devono darsi sostegno, perché hanno bisogno una 
+dell'altra per la combinazione che si opera parte con 
+parte. Non devono essere opposte una all'altra, perché 
+bisogna che una volta mescolate non si separino una 
+dall'altra. 
+ Tu devi operare in una sola volta, in maniera continua, 
+senza interruzione, per realizzare la mescolanza delle 
+parti, le une con le altre. Dovrà esserci equilibrio per 
+quanto riguarda la natura, la quantità e il peso. 
+L'operazione dovrà essere rigorosa, senza che si possa 
+sostituire una sostanza a un'altra. 
+L'elemento corporale è dominato dall'elemento spiri-
+tuale in seguito all'operazione vera che lo trasforma in 
+elemento spirituale. L'elemento spirituale è ugualmen-
+te dominato dall'elemento corporale e trasformato in 
+elemento corporale, sebbene in realtà non vi sia oppo-
+sizione completa tra questi due elementi. 
+La massa delle cose corporali è soltanto il luogo di sog-
+giorno e rifugio delle cose spirituali, e non ha di per sé 
+né forza né utilità quando la forza agente ha cessato di 
+agire in lei. 
+Il corpo che resta come sostrato non è che il luogo di 
+soggiorno e il rifugio dello spirito che ne è uscito, e non 
+ha forza se non per lo spirito che può uscire da lui. 
+Sono bloccato su questi passi, che da un lato mi 
+appaiono chiari, dall'altro non so tradurre in pra-
+tica. 
+E vero che sempre in Jabir leggo: 
+Ho visto in effetti moltiplicando il numero dei miei 
+libri, allungandoli e riempiendoli di fatti, che nessuno 
+potrà arrivare ad estrarne la verità a meno di consa-
+crarvi tutta la propria vita, di avere un'intelligenza 
+superiore, di dedicarvi tutto il proprio studio, di veglia-
+re notte e giorno e di rinunciare a frequentare i propri 
+amici, privandosi del completo benessere. 
+ Quindi non posso che rendermi conto che le 
+difficoltà che incontro sono inevitabili. Leggo pe-
+rò anche: 
+Fatevi aiutare dalle persone intelligenti che si occupa-
+no di questi lavori, perché i libri sono inchiavardati, e 
+le chiavi dei loro catenacci sono nei petti degli uomini. 
+Non posso che rivolgermi a voi per avere que-
+ste chiavi. 
+Rispettosamente. 
+ QUARTA RISPOSTA 
+Caro studioso, 
+Si dice che Jàbir abbia incontrato l'Imam Ja'far 
+al-Sàdiq quando aveva circa vent'anni in uno dei 
+suoi nascondigli, presso la tribù degli Azid nello 
+Yemen, e che diventò suo discepolo sin da allora. 
+La sua personalità perciò si formò religiosamente, 
+politicamente, scientificamente ed eticamente co-
+me guardiano della dottrina dell'Imam. 
+Di conseguenza ecco Jàbir l'adoratore, lo gno-
+stico Sufi, il lottatore politico e il ben informato 
+maestro di Alchimia. 
+L'Imam Ja'far, come maestro di setta e di pen-
+siero, e uomo di miracoli e poteri occulti della 
+discendenza del Profeta, era l'oppositore politico 
+del potere Abbaside da quando si era posto come 
+guardiano dei valori islamici e dei loro concetti. 
+Si può percepire il tipo di relazione e di intimità 
+spirituale di meravigliose visioni e profondità tra 
+l'Imam Abi Abdullah e il suo discepolo Jàbir. Gli 
+aspetti di questo legame sono numerosi e ovvia-
+mente diversi nei suoi scritti, nel suo stile, nella 
+ sua mentalità e nella sua metodologia. Si può rico-
+noscere la presenza dell'Imam Ja'far potentemen-
+te dietro ogni riga scritta da Jàbir, e nessuno dei 
+suoi trattati fa eccezione. Questa presenza si cela 
+nel testo come metodo scientifico-mistico ed è in-
+dicazione armoniosa della convergenza dell'esso-
+terico e dell'esoterico. E un profondo amore spiri-
+tuale in tutto il significato sublime e in tutte le 
+dimensioni, mescolato a senso di gratitudine e glo-
+rificazione per il suo grande maestro che ha svela-
+to l'occulto segreto della conoscenza e fatto ribol-
+lire le meravigliose tacite fontane della genesi e 
+della creazione davanti ai suoi occhi. 
+Dice Jàbir: 
+I gradi dell'Elixir devono stare sulla linea della bilancia, 
+questo si deve sapere. Nell'onorevole diritto del mio 
+maestro, io giuro che questo è senza simboli e senza 
+prolissità. 
+In un altro passo, Jàbir dice che il suo maestro 
+gli ordinò: 
+Prepara un libro di piena maturità e profondità con più 
+essenza e meno prolissità sull'alchimia, e poi mostra-
+melo. 
+La risposta di Jàbir fu l'obbedienza, ed egli disse: 
+ L'ho fatto nel diritto pieno di grazia del mio maestro, 
+ho rivelato cose, le ho ridotte all'essenza. Ho mostrato 
+alla gente la giusta via. 
+Jàbir dichiara anche che il maestro gli donò la 
+visione penetrante della bilancia, e diffuse la sua 
+parola su questo dicendo: 
+Così parla il maestro, e così egli mi ordinò di scrivere e 
+classificare. 
+Molte volte egli menziona le direttive del suo 
+maestro e parla del Mercurio: 
+Il mio maestro mi raccontò tutto intorno ai suoi padri, 
+uno ad uno. 
+Questo tipo di pensiero raggiunge il suo sommo 
+e la sua presenza sublime una volta che si ricordi 
+il messaggio che l'Imam Ja'far dettò a Jàbir, suo 
+discepolo favorito, sul segreto della natura e sulle 
+più piccole cose della saggezza universale che pos-
+sono essere riassunte come espressioni dell'Opera. 
+La visione dei fatti taciti dell'esistenza attraverso la 
+contemplazione esoterica. Il principio della bilan-
+cia come si deduce dalla giustizia divina e dal sen-
+so Qur'anico del mondo: 
+Ed Egli ha fatto sorgere alto il firmamento, ed Egli ha 
+fissato la Bilancia [di giustizia], (Sura LV, 7) 
+ Secondo Jabir la realizzazione totale della pro-
+fessione alchemica viene attraverso due percorsi: 
+l'esterno essoterico e l'interno esoterico. 
+Il primo cammino è la realizzazione del ragio-
+namento e dei tratti delle leggi generali e dello sta-
+to di unione di natura, mente e anima. 
+Il secondo cammino, l'esoterico, è legato alla 
+conoscenza delle leggi e degli stati impegnati ver-
+so il divino. Questo cammino può essere stabilito 
+mantenendo i grandi fatti universali e la purifica-
+zione di se stessi e dei propri fini, insieme a chia-
+rezza e sincerità interiori. 
+Le grandi rivelazioni, come la conoscenza del-
+l'interiore, Jàbir le ottenne attraverso il suo mae-
+stro Ja'far Abi Abdullah Al-Sàdiq, perché le fon-
+tane essoteriche sono le ombre di quelle esoteriche 
+che fluiscono dalla luce divina latente nello spiri-
+to dell'uomo. 
+L'Imam Sàdiq indicò a Jàbir il profondo senso 
+di soddisfazione, quiete e tranquillità e gli rivelò i 
+cammini per visualizzare il tacito, e l'innata attra-
+zione verso la conoscenza del vero senza veli. 
+Inoltre Jàbir asserisce il significato della bilan-
+cia come conoscenza del numero, del rapporto di 
+quantità e delle leggi degli elementi di natura e dei 
+composti, ai quali si riferisce nei trattati che seguo-
+no il criterio dell'analogia. 
+ Esoterico ed essoterico, secondo Jàbir, simbo-
+leggiano l'alternata apparizione e scomparsa del-
+l'Imam Ja'far al-Sàdiq. 
+Caro studioso, non mi fraintendere, si sta medi-
+tando sul compendio della saggezza. 
+La pace sia con te. 
+ QUINTA LETTERA 
+Caro Maestro, 
+ho finito la lunga preparazione dei materiali: li 
+ho purificati, esaltati, predisposti con cura per il 
+primo incontro. 
+E primavera, tra poco inizierò la quarantena 
+sacra. La materia è nel suo nido, ne attendo con 
+ansia il risveglio. Attendo, come dice Boehme, che 
+scendano gli angeli. 
+Lavorando quietamente, la riflessione sulle qua-
+lità e le preparazioni della materia conduce a quel-
+le òdi'artista. 
+I maestri danno poche indicazioni, insoddisfa-
+centi. Il tema sembra o poco importante o sconta-
+to. Si sottolinea la necessità di buoni caratteri fisi-
+ci: salute e integrità di corpo. Si aggiungono 
+facoltà intellettive: memoria, comprensione, facile 
+apprendimento. Si cita dedizione allo studio e al 
+lavoro, paziente costanza. Pietas, timor di Dio, 
+innocenza, sono ricordati pudicamente. 
+Riassume tutto molto concisamente Geber la-
+tino: 
+ Diciamo pertanto, che se non avrà ingegno naturale, e 
+una mente che scruti sottilmente i principi naturali, e i 
+fondamenti della natura, non troverà la vera radice di 
+questa preziosissima scienza. Inoltre ne abbiamo trova-
+to molti, che hanno una mente che crede facilmente a 
+qualsiasi fantasia. Ma il vero che credono di aver tro-
+vato, è affatto fantastico, aberrante, e pieno di errori e 
+lontanissimo dai principi naturali, poiché il loro cervel-
+lo, colmo di molte fumosità, non può accogliere il vero 
+intento delle cose naturali. Altri ancora sono schiavi del 
+denaro: desiderano questa scienza, affermano che essa 
+è meravigliosa e vera, ma temono le spese. Pertanto, 
+sebbene ne siano convinti, e la indaghino correttamen-
+te, tuttavia non giungono all'esperienza dell'opera per 
+avarizia di denaro. Pertanto a tutti questi non giunge la 
+nostra scienza. 
+Siamo nell'ovvietà. Stupisce la mancanza di sof-
+ferenze meritorie, quelle che sono norma per qual-
+siasi cammino di perfezione, fatte di sacrifici, asce-
+si, rinunce, digiuni: ci si purifichi, immersi nel do-
+lore, se appena si vuole ottenere qualcosa. 
+Sono disarmato di fronte a questo silenzio. Pare 
+manchi qualcosa, un vuoto da colmare che cerco 
+di soddisfare con altri insegnamenti, riversando 
+sensi simbolici in frasi dall'apparenza innocua. 
+L'Opera è essenzialmente arte del fuoco, e l'al-
+chimista proprio per questo può diventare philo-
+sophus per ignem, filosofo per mezzo del fuoco. 
+Leggo perciò con una certa preoccupazione Jàbir 
+quando afferma: 
+ Il fuoco aumenta le virtù del saggio e la corruzione del 
+perverso. 
+Un problema dunque si pone, che voi avete più 
+volte definito come necessità dell'«etica della te-
+stimonianza», ed io chiedo praticamente dove 
+conduca. Perché siamo affamati di precetti, di leg-
+gi da seguire. 
+Una norma tuttavia esiste, misteriosa e incom-
+prensibile: «Siate veridici». Sottolineata come vir-
+tù singolare e significante, è difficile coglierne il 
+valore. Non si trova come regola di santità, am-
+mettendo che santità sia strumento di misura. Non 
+è difficile da praticare nella sua formulazione più 
+evidente. 
+Proprio per questo temo abbia significati più 
+profondi, difficili da decifrare. 
+Rispettosamente. 
+ QUINTA RISPOSTA 
+Caro studioso, 
+tu devi capire che esiste una veracità della lin-
+gua, e una veracità del cuore, e che è della secon-
+da che noi parliamo. 
+La prima consiste nel fatto che la tua lingua non 
+dovrebbe mentire. La seconda consiste nel fatto 
+che il tuo cuore non dovrebbe mentire. 
+La menzogna della lingua consiste nel soffer-
+marsi su ciò che non è stato detto, e nel dire e non 
+fare. La menzogna del cuore consiste nel credere 
+e non fare. La menzogna del cuore consiste nel 
+dare ascolto ad una menzogna. 
+Ogni menzognero è altro da me. 
+La verità autentica è la mia voce: se io voglio fac-
+cio parlare con essa una pietra o un uomo. 
+Qualunque cosa ti lega a me è il mio discorso che 
+proviene dalla mia voce. 
+Il desiderio è una menzogna del cuore. Il deside-
+rio è il seme del Nemico in ogni cosa. 
+Io ti ho reso inadatto ad ogni cosa e ho fatto si 
+ che questo fosse un velo tra te e questo. Non lace-
+rare il velo prestando attenzione alle cose, perché io 
+manderei su di te la loro umiliazione. Se tu fossi sta-
+to adatto ad ogni cosa, io non ti avrei rivelato il mio 
+volto. 
+Quando ti capita qualcosa con la sua tentazione, 
+considera l'origine della sua creazione e vedrai che 
+questa la condurrà via da te. Se tu non vedi l'origi-
+ne della sua creazione, allora considera il fine del 
+suo manifestarsi, e vi cercherai religiosità 
+dentro, 
+ma tu non la vedrai. 
+L'origine è forza, il fine è debolezza: 
+chiedimi 
+perdono per una debolezza su cui hai potere per 
+mezzo di una debolezza. 
+La pace sia con te. 
+ .tléimiltife 
+uutraa :cm 
+i
+i
+m
+o ftr ìan'um 
+i
+n
+.
+«
+K
+T
+U i-H'.^»'. 
+mm 
+••><..ì 
+^ 
+]dbir, il Maestro dei Maestri, chiamato Gcber dai latini 
+ Caro Maestro, 
+la primavera è passata immersa nell'operosità. 
+L'essoterico risponde alle attese: i fenomeni sono 
+stupefacenti e meravigliosi, i colori splendidi, i ri-
+sultati prodigiosi. 
+L'esoterico non appaga: manca qualcosa di es-
+senziale, compaiono immagini di illusione. 
+Un vecchio maestro di Francia scriveva: 
+Ecco il segreto. 
+Sappi che tutti parlano allo stesso modo in due modi, 
+di cui uno è vero e l'altro falso. 
+Il vero è tale da non poter essere inteso che dai soli 
+Illuminati che camminano rettamente e secondo natu-
+ra, ed è tuttavia coperto da paragoni ed esempli, sotto 
+nomi ed equivoci che non appartengono alla dottrina 
+ma ne sono significanti, perché in lei non occorre che 
+una sola cosa, un solo modo di operare, per una via 
+semplice e naturale, senza perdersi nella pluralità delle 
+cose contrarie al nostro unico lievito. 
+Il falso è questa confusione di regimi e droghe cattive, 
+sebbene il tutto sia significante di qualcosa che appar-
+tiene alla dottrina, tuttavia non si deve considerare la 
+qualità, perché la Natura è semplice e non opera che 
+semplicemente. 
+53 
+ È il momento del dubbio e dell'incertezza, mo-
+mento fatale e pericoloso, forse inevitabile. Il con-
+fine tra vero e falso, tra inganno e realtà, è molto 
+più sottile di quel che si possa immaginare, e lo 
+stesso operare a questo punto è causa di ulteriore 
+incertezza. 
+Tutti hanno opinioni sulFAlchimia. Due ipotesi 
+riassumono i pensieri sulla Grande Opera. 
+Una dice che le operazioni descritte sembrano 
+chimiche, mentre in realtà sono spirituali, o men-
+tali: descrizioni psicologiche dell'evoluzione inte-
+riore, atti dell'immaginare o della volontà, visioni 
+che nascono dall'intimo. 
+L'altra assimila il forno al corpo fisico dell'uo-
+mo, e la materia a un'energia sottile che deve cre-
+scere, salire, cuocere nei suoi intimi recessi. 
+Entrambe leggono l'Opera come simbolo, anzi 
+come allegoria di diverse verità. 
+Attraggono e respingono: entrambe suonano 
+difettose nella loro estrema ragionevolezza. 
+Ricordo un passo che mi avete insegnato: 
+Noi proponemmo il deposito dei nostri segreti ai Cieli, 
+alla Terra, ai Monti: tutti rifiutarono di assumerlo, tut-
+ti tremarono al pensiero di riceverlo. Ma l'uomo ac-
+cettò di incaricarsene: è un violento, un incosciente. 
+(Sura XXXIII, 72) 
+ Sento che si devono scoprire pensieri insensati, 
+vedere cose irragionevoli, sentire stridori inaccet-
+tabili: scopro che nell'Opera si può vedere e non 
+vedere, conoscere e non conoscere. Gli stessi 
+occhi nascondono le cose, le orecchie cancellano i 
+suoni, la mente ricompone tutto a sua immagine, 
+la caligine infittisce di fronte al meraviglioso, come 
+se volesse proteggerlo in una deformazione appro-
+priata all'osservatore. 
+Tutto appare chiaro e comprensibile, e questa 
+stessa sensatezza, tanto gradevole, tanto conve-
+niente, genera perplessità e angoscia. Manca l'eso-
+terico dell'esoterico. 
+Distinguere tra il vero e il falso di cui parla il 
+vecchio maestro sembra impossibile. 
+Rispettosamente. 
+ SESTA RISPOSTA 
+Caro studioso, 
+la verità è ciò da cui non ti allontaneresti, anche 
+se tutto il popolo del cielo e della terra te ne allon-
+tanasse. La falsità è ciò che non accetteresti, anche 
+se tutto il popolo del cielo e della terra ti invitasse 
+a farlo. Ora, per comprendere meglio quanto sto 
+per dirti, devi imparare a distinguere tra stato e 
+situazione. Il primo è un dono di Dio, la seconda 
+è il risultato della tua opera. 
+Stato e situazione sembra siano la stessa cosa 
+perché differiscono solo minimamente a causa del-
+la loro intercambiabilità, ma una situazione è una 
+fase durante un cambiamento, mentre lo stato è 
+tale per la sua stabilità. 
+Una situazione si muove per diventare stato, 
+come l'emissione di un dubbio da parte dell'ado-
+ratore si concretizza tacitamente nella richiesta 
+della verifica. 
+La struttura ricorrente dell'apparire e scompa-
+rire del dubbio è il risultato di un conflitto nell'a-
+rena del sé. Questa è una situazione. 
+ Il superamento del dubbio, sostenuto da fede 
+profonda che trascende il sé, diventa uno stato. 
+La situazione della verifica viene dopo, perché 
+colui che ha lo stato del dubbio, vorrebbe avere la 
+situazione della verifica. 
+La situazione della verifica va e viene con pie-
+nezza di mente e mancanza di mente nel profon-
+do dell'essenza dell'adoratore, sino a quando la 
+nebbia della mancanza di mente scompare soste-
+nuta dal sostegno di Dio per rendere la verifica 
+uno stato. 
+Lo stato del dubbio non si fissa mai a meno che 
+la situazione della verifica non si sostanzi, e questo 
+stato non si fissa sinché non avviene la situazione 
+della vista. 
+Con i doni della vista, la verifica si fissa come 
+stato, dopo essere stata una situazione. 
+L'avvento della vista diventa una situazione che 
+va e viene con un velame. Allora diventa uno 
+stato: 
+E il suo sole libera dall'eclissi, dal velame e dalla 
+nebbia. 
+La visione della verità scende nelle profondità 
+del cuore per essere la situazione più alta della 
+visione. 
+ Il nostro Profeta Mohammad - la pace su di 
+lui - dice: "O Signore, io ti prego di farmi avere 
+un dono di fede che penetri il mio cuore". 
+Conoscimi con la gnosi della certezza rivelata, fa 
+noto il tuo sé al tuo Maestro per mezzo di certezza 
+rivelata. Scrivi il modo della mia autorivelazione a 
+te per mezzo della gnosi della certezza rivelata, scri-
+vi come io ho fatto sì che tu fossi testimone e come 
+tu abbia reso testimonianza. Questo può essere un 
+ricordo per te e uno stabilirsi per il tuo cuore. 
+Sappi che i doni di Dio Onnipotente sono sen-
+za limiti, e situazione e stato sono doni correlati 
+alle parole di Dio che sono troppo numerose per 
+essere scritte anche avendo l'inchiostro di tutti i 
+mari, e sono più innumerevoli dei granelli di tutte 
+le sabbie. 
+Dio è il misericordioso dispensatore e donatore. 
+Egli mi pose nella verità della gnosi e mi disse: 
+Come per questo momento c'è un sopra e un sot-
+to, tutti i fenomeni sono questo mondo e tutto que-
+sto insieme e tutto ciò che contiene sta in attesa 
+dell'Ora. Sopra di lui e sopra tutto ciò che contiene 
+ho scritto la fede, e l'essenza della fede è: "Non c'è 
+nulla come lui". 
+ Chiama a testimoniare Gabriele e Michele, 
+chiama a testimoniare il Trono e i portatori del 
+Trono, chiama a testimoniare ogni angelo e ogni 
+possessore di gnosi, e vedrai la realtà della sua 
+fede, mentre dice e dà testimonianza che non c'è 
+nulla come lui. 
+Tu vedrai che conoscenza di questo è esperien-
+za, e che esperienza di questo è conoscenza. 
+Tu vedrai che questo è il limite della gnosi, 
+vedrai che quella è l'autentica verità, vedrai che 
+quella è la vera conoscenza della visione, non la 
+visione in sé. 
+Osservali: ciascuno di loro veglia in attesa del-
+l'Ora. Attendono che si alzi il velo, attendono il 
+levarsi della copertura. 
+Ma non si possono sopportare le condizioni di 
+realtà di colui che sta dietro al velo, se non per suo 
+mezzo. 
+Come sarà quando il velo sarà strappato? Per-
+ché il velo sarà strappato e in questo strappo sta 
+un assalto che non può essere sostenuto dalla 
+natura delle cose create. 
+Se il velo fosse alzato e non strappato, colui che 
+sta sotto di lui troverebbe riposo. Ma è strappato 
+e quando questo avviene la gnosi dello gnostico 
+sarà dimenticata. Nel dimenticare sarà rivestita da 
+una luce, che farà sì che si possa sopportare ciò 
+ che si manifesta dopo lo strappo. E questo dimen-
+ticare è un bene perché con la gnosi non si potreb-
+be sopportare ciò che viene manifestato. 
+La pace sia con te. 
+Carovana di pellegrini 
+musulmani. 
+ SETTIMA LETTERA 
+Caro Maestro, 
+l'unione delle Nature è un mistero che non si 
+riesce a penetrare. La congiunzione degli opposti 
+richiede un Mediatore che pare più divino che 
+umano. Credo sia del genere di cui parla Jàbir nel 
+Libro della Misericordia: 
+Quante cose ci sono in questo mondo, spirituali e sot-
+tili, che i sensi non possono percepire e che non si pos-
+sono conoscere che per intelligenza! 
+Mentre riprendo molto umilmente e paziente-
+mente le materie per predisporle all'Opera, stu-
+dio, medito, cerco di capire. In effetti capire non è 
+verbo da usarsi, perché questo arcano lo credo 
+occultato dalla sua stessa assurdità. Per la realiz-
+zazione si deve concepire qualcosa di inesplicabi-
+le, e questa non sarà una comprensione, può esse-
+re una visione. 
+Torno, ai libri con maggior prudenza. Ho letto 
+il racconto di Khalid, il principe alchimista: 
+ Sappi che il mio discepolo Musa, il più onorevole di 
+tutti presso di me, studiò molto sui libri (dei Sapienti) 
+e faticò molto nell'opera del magistero, ma non riuscì a 
+conoscere il modo della composizione. 
+Allora, supplice e umile, me ne chiese una spiegazione 
+e un consiglio. Io non gli detti risposta né indicazioni, 
+ma gli prescrissi di leggere i libri dei Filosofi e di cer-
+care in quelli ciò che aveva chiesto a me. 
+Egli allora, andatosene, lesse più di cento libri, tutti 
+quelli che potè trovare: libri certamente veridici, segre-
+ti, dei più nobili Filosofi, ma non vi potè trovare ciò che 
+cercava, e rimase attonito e quasi stravolto. 
+Penso che l'errore più ovvio consista nel ricon-
+durre tutto alle operazioni, alle esperienze fatte, in 
+una interpretazione ingenuamente tecnica. Mi ri-
+peto le parole di un antichissimo filosofo musul-
+mano: 
+Quest'arte non è forse Cabalistica e piena di grandissi-
+mi segreti? E tu, stupido pazzo, tu credi che noi inse-
+gniamo chiaramente i segreti dei segreti? E prendi le 
+parole secondo il loro suono letterale? 
+Sappi per certo che chiunque prende le parole dei 
+Filosofi secondo il significato volgare e ordinario, sba-
+glia enormemente. 
+Ho ripreso il Libro delle Bilance, e mi perdo in 
+infiniti giochi di cabala, che stupiscono per l'e-
+strema sottigliezza delle analogie. Con queste ten-
+ to di penetrare nel contenuto delle lettere, di 
+vedere ciò che queste racchiudono, la sostanza, 
+non il vaso. 
+Mi smarrisco in innumerevoli esercizi, correla-
+zioni, scomposizioni minuziose e calcoli labirinti-
+ci. Lascio il senso letterale e ne scopro mille occul-
+ti che svelano e ri-velano, come statuine russe che 
+sembrano non dover mai finire in un continuo 
+rimpicciolirsi. 
+Jabir voleva insegnarci a pesare lo Spirito, capi-
+sco che il mio strumento non è corretto, le misu-
+razioni si perdono in un'analisi sterile nella sua 
+apparente, mostruosa, fecondità. 
+La materia è silente. Temevo la sua voce, ora il 
+suo silenzio mi offende. 
+Rispettosamente. 
+ SETTIMA RISPOSTA 
+Caro studioso, 
+considera la lettera e ciò che contiene dietro di 
+sé. Se presti attenzione alla lettera, vi cadrai den-
+tro. Se presti attenzione a quello che contiene, 
+cadrai in quello che contiene. 
+Non disperare: la generosità di Dio è più grande 
+della lettera di cui trovi la teoria e della lettera di 
+cui conosci la teoria, della lettera di cui non trovi 
+la teoria e della lettera di cui non conosci la teoria. 
+Quando tu stai con Dio, vedi cosa scende e cosa 
+sale, e ogni lettera viene da te con tutto ciò che 
+contiene, e ogni cosa si rivolge a te nella sua lin-
+gua e ogni esposizione si spiega per te secondo la 
+sua esposizione. 
+La guida appartiene per natura al velo, e il velo 
+è la punizione. Perciò se la tua guida è della natu-
+ra del velo, sarai velato dalla realtà di ciò verso cui 
+sei guidato: 
+Io sono il velo del mio gnostico, e sono la guida 
+del mio gnostico. Io faccio conoscere me stesso ed egli 
+ mi conosce e sa che io faccio conoscere me stesso. Io 
+velo me stesso, ed egli mi conosce e sa che io velo me 
+stesso. 
+Caro studioso, colui la cui guida non è Dio, non 
+è unito a Dio. Ascolta: 
+Quando tu conosci la conoscenza che procede da 
+me, io ti punisco se segui coloro che non sanno, e ti 
+punisco anche se segui coloro che sanno. 
+L'uomo che è sotto l'effetto del sé, sta sotto il 
+velo della tenebra a causa della sua esistenza mate-
+riale. Ma quando il suo cuore esce dal suo velo, 
+allora raggiunge la vicinanza senza l'effetto del sé. 
+L'ignoranza è il velo della visione e la cono-
+scenza è il velo della visione. Egli è il manifesto 
+senza velo e il nascosto senza svelamento. 
+Colui che conosce il velo è vicino allo svela-
+mento. Il velo è uno, le cause per mezzo delle qua-
+li si manifesta sono diverse, e queste sono vari veli. 
+Ascolta l'Imam Ja'far: 
+La nostra causa è un segreto dentro un segreto, il segre-
+to di qualcosa che resta velato, è un segreto che solo un 
+altro segreto può spiegare, è un segreto su un segreto 
+che si appaga di un segreto. 
+La pace sia con te. 
+ jabir tra i grandi Maestri dell'Alchimia 
+occidentale. 
+ OTTAVA LETTERA 
+Caro Maestro, 
+un quesito si impone, continuo, a chi è sulla 
+Via, che si ripete ad ogni grado in forme rinnova-
+te eppure costanti. 
+Si può tradurre molto semplicemente. Consiste 
+nella necessità, e nell'impossibilità, di conciliare 
+l'esistenza banale, terrena, quotidiana, con la sa-
+cralità dell'Opera e con le sue manifestazioni spi-
+rituali. 
+Chi non abbandoni per un eremitaggio o una 
+cella la vita che conduce nel mondo, soffre di que-
+sta antinomia persecutrice e non sa, o non può, 
+risolverla. Rischia di essere incapace nell'uno e 
+nell'altro luogo, zoppo per avere un piede qui e 
+uno altrove, instabile nella più assoluta precarietà. 
+Un alchimista cinese insegnava: 
+La ricerca non è complicata. Basta fare alcune cose. 
+L'unico problema è che quasi sempre la volontà non è 
+ferma e la fede non è confermata. 
+Perché trascurare gli interessi umani? Il vero artista rie-
+sce senza difficoltà ad occuparsi degli affari e del-
+l'Opera. Mentre in privato osserva rigorosamente la 
+ Via, pubblicamente è impegnato negli affari mondani. 
+In tal modo raggiunge una grande perfezione perché è 
+tenuto a controllarsi. 
+Una tale persona è eccellente. 
+Scriveva secoli fa. Sorge il dubbio che inserito 
+in una società, come si suol dire, tradizionale, 
+potesse sostenere onestamente opinioni che oggi 
+non è dato immaginare. 
+La sofferenza più grande consiste nella perdita 
+quando si è ricondotti alla discesa nel profano. Ne 
+viene un inevitabile senso di fastidio per tutto ciò 
+che ci vuole immobili nel mondo, una profonda 
+insofferenza. Ma quello che davvero appare insop-
+portabile è il timore di non poter tornare nel luo-
+go da cui siamo stati strappati, di aver perso il 
+Dono per mancanza di consuetudine, peggio, per 
+distrazione. 
+Stupisce che l'acquisito si possa perdere con 
+tanta facilità, e lo stupore diviene ansia di ritorno, 
+angoscia di aver perso la strada. 
+La domanda perciò si complica. Diventa richie-
+sta di una guida nel comportamento, di un modo 
+per non abbandonare la visione, di un metodo che 
+renda laboratorio ogni atto del vivere e permetta di 
+continuare senza interruzioni. 
+Mi chiedo se sia possibile. 
+Rispettosamente. 
+ OTTAVA RISPOSTA 
+Caro studioso, 
+un seminatore seminò una manciata di semi, ma 
+egli non aveva ancora raggiunto la strada, che li 
+uccelli li avevano mangiati. Alcuni altri semi creb-
+bero su una roccia liscia su cui c'era poca sabbia e 
+poca rugiada: le loro radici soffocarono nella soli-
+da roccia e furono spazzate via. Alcuni altri semi 
+crebbero in una buona terra, ma questa era piena 
+di rovi che li soffocarono e distrussero. Altri semi 
+crebbero in una buona terra senza rocce né rovi e 
+si trasformarono in buona forma e frutti. 
+Il seminatore è come parlare della rettitudine, e 
+ciò che avviene per strada è come un uomo che tro-
+va il racconto dell'ascoltare inutile: appena l'avrà 
+ascoltato, il diavolo lo strappa via sinché lo dimen-
+tica. 
+I semi sulla roccia liscia sono come un uomo 
+che trova il discorso degno di essere ascoltato, 
+eppure questo raggiunge un cuore che non vuole 
+comprenderlo a fondo, e così la parola declina. 
+I semi nella terra dei rovi sono come un uomo 
+ che trova la parola degna di essere ascoltata, eppu-
+re i piaceri si sono stabiliti nel petto intorno al 
+cuore, la materia non può essere compresa a fon-
+do per i suoi pregiudizi e la sua volubilità. 
+I semi che crescono sulla terra buona, senza 
+rocce né rovi, sono come il discorso che raggiun-
+ge un cuore e vi resta per essere compreso a fon-
+do. E come un albero con i rami nel terrestre e le 
+radici profondamente stabilite nel celeste. Il suo 
+frutto è gustoso, bello a vedersi e aromatico, e atti-
+ra gli uomini da ogni parte del mondo. 
+II mio nome e i miei nomi sono posti dentro di 
+te: non cacciarli o io mi allontanerò dal tuo cuore. 
+Egli stava dentro di me e mi disse: 
+La conoscenza è più dannosa dell'ignoranza per 
+colui che mi vede. 
+Una buona opera vale dieci per colui che non mi 
+vede, ma è danno per colui che mi vede. 
+Quando tu mi vedi, la tua sicurezza è più grande 
+nell'omissione che nel servizio. Quando tu non mi 
+vedi, la tua sicurezza è più grande nel servizio che 
+nell'omissione. 
+Quando tu mi vedi, ogni cosa che tu vedi altra da 
+me con il tuo occhio e il tuo cuore, ti separa da me. 
+ Chiedi il mio perdono per l'atto del cuore, e io ti 
+libererò dalla mutevolezza. 
+L'atto del cuore è la radice dell'atto del corpo: 
+considera quindi cosa hai seminato e considera qua-
+le frutto porta la semenza. 
+La mia mano è sul cuore. Perciò se tu trattenessi 
+da esso la sua propria mano, né prendendo con essa 
+né dando, tu semineresti la mia autorivelazione per 
+mezzo di esso, ed esso produrrebbe il frutto di ve-
+dermi. 
+Temi una buona azione che demolisce le buone 
+azioni, e temi un peccato che erige i tuoi peccati. 
+Quando tu mi vedi e ottieni da me i mezzi del-
+l'indipendenza, io non sarò assente da te. 
+La tribolazione è la tribolazione di colui che mi 
+vede. Egli non può sopportare la mia persistenza, e 
+non può sopportare la sua interruzione. Mentre io 
+sono al centro di questo, srotolandolo e arrotolandolo. 
+Neil'arrotolare sta la morte, nello srotolare sta la vita. 
+Io sono l'obiettivo dei miei amici cari. Quando 
+essi mi vedono, essi trovano riposo in me. Chi non 
+mi vede, egli è il proprio obiettivo. 
+Consulta colui che non mi vede per i tuoi affari 
+di questo mondo e del prossimo. Segui l'esempio di 
+colui che mi vede e non consultarlo. La consulta-
+zione è per la liberazione dall'errore, e il consiglio è 
+un assalto. Chi mi vede, dove non assalirà? 
+ Accompagna colui che non mi vede, ed egli ti sor-
+reggerà e tu sorreggerai lui. Non cercare la compa-
+gnia di colui che mi vede, o ti sarà teso un agguato 
+da ciò in cui hai riposto la massima fiducia. 
+Quando tu vedi me e vedi colui che non mi vede, 
+velami da lui per mezzo della saggezza: se tu non lo 
+fai ed egli si smarrisce, io ti punirò per lui. 
+Quando tu non mi vedi e vedi colui che mi vede, 
+conserva le tue limitazioni, perché tu non mi vedrai 
+attraverso la sua visione. 
+Quando tu mi vedi e vedi colui che mi vede, allo-
+ra io sono tra voi due, ascoltando e rispondendo. 
+Coloro che perseverano per il proprio vantaggio, 
+sono coloro che mi vedono. 
+Quando io ero assente, velarono gelosamente 
+i 
+loro occhi, per non associare nulla a me nella loro 
+visione. 
+La gelosia non è giusta finché distrugge la divi-
+sione, e la divisione non è distrutta mentre io sono 
+assente. 
+In verità Noi li guideremo sulle Nostre vie. Noi 
+sveleremo loro in ogni cosa i posti su cui cade il 
+Nostro sguardo. 
+Noi diamo ordini ad una cosa quando vogliamo, 
+e facciamo sì che essa testimoni la gnosi. E quando 
+possiede la gnosi, Noi diciamo ad essa "Sii", ed essa 
+è, in risposta al nostro comando. 
+ La descrizione di tutto ciò, nella visione del tuo 
+cuore e del tuo intelletto, è che nel profondo tu 
+dovresti essere testimone di ogni mondo e di ogni 
+paradiso, di ogni cielo e di ogni terra, di ogni ter-
+reno e di ogni mare, e di ogni notte e di ogni gior-
+no, e di ogni profeta e di ogni angelo, e di ogni 
+conoscenza e di ogni gnosi, e di ogni parola e di 
+ogni nome, e di tutto ciò che è in quello e di tutto 
+ciò che è tra quello, dicendo: "Non c'è nulla come 
+Lui!". Allora sarai all'estremo della conoscenza e 
+alla fine della gnosi. 
+Possedendo la gnosi della gnosi, tu conosci e sco-
+pri che sei uno dei tuoi animali: allora rendi la tua 
+esistenza fenomenica, nella sua totalità, una delle 
+tue vie. 
+Quando hai fatto sì che l'esistenza fenomenica 
+sia una delle tue vie, questa sarà un guadagno che 
+proviene da una via. 
+La cosa principale è che ora tu dovresti sapere 
+cosa sei, se un eletto o un uomo comune. Perché 
+se un eletto non agisce in base al principio di esse-
+re un eletto, perisce, mentre con la semplice cono-
+scenza dell'uomo comune questi è quasi condotto 
+alla salvezza. 
+All'eletto appare una manifestazione di Dio che 
+è salvaguardata da altri che non siano lui, ma non 
+ da lui. Per quanto riguarda l'uomo comune, non 
+c'è nulla tra lui e Dio eccetto la sua confessione di 
+fede, mentre l'eletto è colui che rivolge tutta la sua 
+attenzione a Dio. 
+La pace sia con te. 
+Le necessarie virtù fisiche, psichiche e spirituali 
+per compiere l'Opera. 
+ NONA LETTERA 
+Caro Maestro, 
+un mondo oscuro e tenebroso, nero e fetido, 
+emette miasmi velenosi e putrescenti. Intorno, un 
+oceano di fuoco dai bagliori di smeraldo si agita 
+ribollendo in mille schiume. Sento squittii pauro-
+si e tintinnii angelici confusi in stridula armonia. 
+La luce si mescola alle tenebre, il rumore al silen-
+zio nei baratri dell'Universo. Questo è il primo 
+mistero incomprensibile. 
+L'Angelo folgora con spada di fiamme, rompe 
+l'ingresso proibito, frantumandolo in mille parti-
+cole che sfuggono come scintille impazzite di ani-
+me dannate e riprese, in un perdono maledetto ed 
+eterno di redenzione malvagia e ingannatrice. La 
+Luce erutta da un vulcano diabolico, sale, ricrolla, 
+si rapprende, sovrasta, raggrumata in un cristallo 
+di magnifico fulgore che il marchio segna: manife-
+sta l'inconoscibile perfezione dell'Immacolata Di-
+vina, fuori dal tempo, dallo spazio, dall'errore in-
+sensato. E il secondo mistero. 
+ Lo raccolgo immerso nell'aroma di balsamo: si 
+apre la visione dove tutto si tace, i colori si fon-
+dono, la quieta pace silente domina il mostro 
+schiacciato, domato, non ancora ucciso. E il terzo 
+mistero. 
+Un flusso ancora putrido di rosso sangue bru-
+nastro comincia a rapprendersi, le squame si in-
+frangono per la passione dell'anima che vuole li-
+bertà alla ricerca di un nuovo corpo, morbido e in-
+corruttibile. 
+L'Angelo mi guarda e tace. Riprende la spada, 
+indica un cammino, breve e lunghissimo, scoglio 
+del mare verde, vulcano innevato ancora senza cie-
+lo nel torpore del mondo. 
+L'operazione è finita sotto il velo di tenebra che 
+ancora ricopre il meraviglioso. L'Angelo è svanito. 
+Restano i corpi maldestri che maneggio con cura 
+rammentando la vita che celano. La materia parla, 
+grida, strepita, risuona e nella confusione elemen-
+tare si confonde la mente che non sa più distin-
+guere il proprio suono dall'altro. 
+Queste sono le immagini e le loro direzioni. 
+Quando cessa la visione, il sonno è profondo, il 
+corpo spossato, non c'è turbamento di sogno, fal-
+ so o verace. La nostalgia si acutizza al risveglio e i 
+ricordi si fondono. L'Angelo torna nell'invisibile, 
+la memoria si distrae in mille voci discordi. 
+Reiterare l'operazione è una necessità che attira 
+e ripugna, spaventa nella sua inevitabilità. La spe-
+ranza sta nel non ritorno, nel poter proseguire. Il 
+timore che la visione non si ripresenti terrorizza. 
+In questo andare e tornare, oscillando tra i mon-
+di, la prova si manifesta in tutta la sua difficoltà. 
+Con chi misurarsi? 
+Rispettosamente. 
+ NONA RISPOSTA 
+Caro studioso, 
+recentemente ho meditato a lungo sulle tue let-
+tere e da queste ho acquisito una conoscenza più 
+profonda delle tue attitudini, delle tue tendenze e 
+dei tuoi segni. 
+Per me i tuoi segni sono divini, anche se con 
+situazioni di pura materia. 
+L'assoluto non è mai limitato, perché la sua 
+bontà è infinita, ma la materia è l'opposto, perché 
+la materia è nascosta solo nel divino, e perciò la 
+tua Opera deve essere del divino, nel divino, fuo-
+ri dal divino e per il divino, proporzionalmente 
+sdoppiata con le opere mondane. 
+Del primo polo, del cammino divino, devi 
+ascoltare la voce con il velo delle sue descrizioni e 
+dei suoi tratti, nel vero dal vero, una volta che tu 
+abbia meritato ascolto e conoscenza. Ma colui che 
+ha il sé ossessionato e il cui intimo è sopraffatto 
+dalla voce del sé non può udire nulla. 
+ Udito e ispirazione richiedono una struttura di 
+esistenza che è data al conoscitore in una situazio-
+ne di sobrietà, mentre il cuore realizza il vero per 
+mezzo dell'esaltazione. 
+Tu devi possedere la vista, cioè la penetrazione, 
+che è stordimento che mescola vista e udito, e devi 
+mantenere sobrietà, non mescolando vista e udito, 
+controllando il tuo stato e la tua situazione. Allora 
+capirai attraverso la tua stessa esistenza, e posse-
+derai completa prontezza per acquisire quella rea-
+lizzazione che è fonte di ispirazione. 
+Questo è l'ascolto del cuore, cui tutto si sotto-
+mette in silenzio. 
+L'assenza di visione è la patria del ricordo. 
+Quando ti manca la visione, e sei assente, chiama 
+e invoca e supplica Dio, ma non chiedere di lui. 
+Perché se tu chiedi di lui a uno che è assente, 
+non ti guiderà a Dio. e se tu chiedi a uno che vede, 
+non ti informerà. 
+La pace sia con te. 
+ Il Profeta visita Jàbir. 
+ DECIMA LETTERA 
+Caro Maestro, 
+L'ascolto è incostante, la visione va e viene 
+come un pendolo oscillante. Sperimentando il 
+profondo si scopre che ad ogni passaggio da un'o-
+pera all'altra l'esoterico di una è essoterico per la 
+successiva, e l'esoterico di questa è essoterico per 
+la più elevata. 
+Fatto esterno l'interno, alto il basso, interno l'e-
+sterno, basso l'alto, fisso il volatile, volatile il fisso, 
+nella successione dei mondi sta un susseguirsi di 
+realtà che non si appartengono, eppure sono un'u-
+nica visione che penetra in modo diverso le mate-
+rie e gli spiriti. 
+Vanno fissate. Si devono bloccare i fuggevoli 
+enti che spingono per tornare all'oriente, con un 
+mercurio d'occidente che li fermi per sempre. 
+Il vaso è quasi pronto, ma instabile, oscilla 
+anch'esso tra un cosmo e l'altro, apparendo e 
+scomparendo dietro un fumo ingannevole che a 
+volte dirada, a volte ispessisce, senza che si possa 
+mai prevedere la forma o il colore. 
+ Tutto è in movimento, ruota intorno al centro 
+che volteggia senza un momento di quiete, e que-
+sto agitarsi che va catturato è come la danza irre-
+sistibile dei mondi universali, il roteare delle sfere 
+eccentriche, dove il centro racchiude la periferia, 
+l'interno è più elevato del punto più esterno, il 
+punto minuscolo pesa più di tutto l'insieme. 
+Ormai la luce pervade tutto il cosmo, il baglio-
+re non acceca, pare piuttosto un'oscurità lumino-
+sa pervasa di stelle sanguigne. 
+Ricordo passi di un antichissimo testo: 
+A lungo era durato l'intervallo di inattività e di cela-
+mento e la materia continuava ad essere sterile. Dio sor-
+rise e disse "Che la Natura sia!" e un oggetto femmini-
+le di totale bellezza sgorgò dalla sua voce, e Dio la 
+chiamò Natura e le ordinò di essere feconda. 
+Avendo preso dal proprio soffio quanto bastava e aven-
+dolo unito intelligentemente al fuoco, lo rimestò con 
+certe sostanze sconosciute. Poi dopo aver unificato il 
+tutto, ogni elemento con ogni altro, accompagnando 
+con certi incanti segreti, agitò fortemente tutta la mistu-
+ra, sinché ribollì alla superficie della miscela una specie 
+di materia più sottile, più pura e più trasparente degli 
+ingredienti di cui era fatta: questa era traslucida e solo 
+l'operatore la vedeva. Ed essa non si fondeva al calore, 
+perché era estratta dal fuoco, e non si raffreddava, per-
+ché era estratta dal soffio. 
+Da questa crosta Dio fece nascere miriadi di anime. 
+ E le cose in basso emisero gemiti, prese da timore per 
+la meravigliosa bellezza e l'eterna permanenza delle 
+cose in alto. 
+Vedo la causa di tutto ciò, il suo eterno ritorno, 
+la legge che lo governa, la mancanza di fine. 
+Vedo la Bilancia e l'oscillazione continua alla 
+ricerca del punto di impossibile equilibrio. 
+Come fermare tutto ciò? 
+Rispettosamente. 
+ DECIMA RISPOSTA 
+Caro studioso, 
+il cuore è sempre in ascolto, il sé è sempre atten-
+to e non riposa mai: qualsiasi cosa chiuda le porte 
+dell'ascolto del cuore proviene dall'attenzione del 
+sé, mentre i piaceri si librano costantemente intor-
+no al cuore degli uomini per impedire la visione 
+dei regni celestiali. 
+L'intuizione di coloro che intuiscono, le cono-
+scenze di coloro che conoscono, le luci degli scien-
+ziati devoti, le vie degli antichi vincitori, il conti-
+nuo inizio e l'eternità, e tutti gli eventi che vi sono 
+compresi, sono per colui che è un ascoltatore del 
+cuore. 
+Egli mi sostenne nella sua realtà, ed io vidi gli 
+scintillìi come tenebra, e l'acqua come una roccia 
+pietrosa. Ed egli mi disse: 
+Colui che non vede questo non è circondato dal-
+la mia realtà, ma colui che vede questo, è stato cir-
+condato dalla mia realtà. Chi è circondato dalla mia 
+realtà e si rivolge ad altri che me, è infedele. 
+ Ogni limitazione è un velo, dietro al quale io non 
+appaio, e non c'è nulla nella visione della mia real-
+tà, a parte la visione di esso. 
+Ed io vidi ciò che non cambia mai, ed egli mi 
+dette una condizione mutevole, ed io vidi tutto ciò 
+che non fu mai creato. Ed egli mi disse: 
+Non fare eccezioni. Ciò che è creato non persiste. 
+E la visione si divise in due parti, oculare e men-
+tale: tutto l'insieme non si muoveva né si esprime-
+va. Ed egli mi disse: 
+ntU- .Vitellàio f 
+•
+»
+"
+•
+•
+f
+j
+f
+c fyf* &itm»> fnir 
+& <
+a
+> wittwl'wivii» tept3o>p<((<tirt%rótc 
+Il drago ermetico ucciso e fatto a pezzi. 
+ Come lo vedevi prima della visione della mia 
+realtà? 
+Dissi: "Si muoveva ed esprimeva". Ed egli: 
+Sappi la differenza, che tu non possa perderti. 
+E mi distolse dalla sua realtà, e non vidi più nul-
+la. Ed egli: 
+Tu vedi tutto e tutto ti obbedisce, e la tua visio-
+ne di tutto è una prova, e l'obbedienza di tutte le 
+cose a te è una prova. 
+E mi distolse da tutto ciò. E mi disse: 
+Io non guardo tutto ciò. Perché non è adatto 
+per me. 
+La pace sia con te. 
+ UNDICESIMA LETTERA 
+Caro Maestro, 
+le fatiche di Ercole sono concluse, è giunto il 
+momento del piccolo riposo, in attesa di quello 
+grande e definitivo. 
+La certezza che l'esilio è prossimo al termine, in 
+un modo o nell'altro, ha quietato ogni affanno, 
+anche se resta la speranza del Dono, qui ed ora. 
+Aspetto la Settimana delle Settimane, come la 
+chiamavano gli antichi maestri latini, quando i 
+giorni della Creazione scorreranno nel nero a pro-
+durre colori angelici. 
+Ho trovato una splendida preghiera, attribuita 
+tradizionalmente a un grande maestro francese del 
+tardo medioevo. Non credo che la conosciate, e ve 
+la voglio proporre: 
+Dio onnipotente in eterno, padre del lume celeste, da 
+cui inoltre provengono tutti i doni buoni e perfetti: 
+Preghiamo la tua infinita misericordia perché tu ci per-
+metta di conoscere rettamente la tua eterna Sapienza, 
+che sta immediatamente prossima al tuo Trono, e per 
+mezzo della quale tutto è stato creato e fatto, ed anche 
+ora è retto e conservato. 
+ Inviala a noi dal tuo Santo Cielo e dal Trono della tua 
+Gloria, affinché stia e lavori insieme a noi, perché essa 
+è maestra di tutte le arti celesti ed occulte, ed inoltre sa 
+e comprende tutto. 
+Fa' che ci accompagni con misura in tutte le nostre ope-
+re, affinché per mezzo del suo spirito noi si apprenda, 
+con certezza e senza alcun errore, il vero significato ed 
+il processo infallibile di questa Nobilissima Arte, cioè la 
+Pietra miracolosa dei Sapienti, che hai nascosto al mon-
+do, e sei solito rivelare almeno ai tuoi eletti, cosicché 
+innanzitutto incominciamo rettamente e bene la somma 
+opera che qui dobbiamo compiere, progrediamo con 
+costanza in essa e nella sua fatica, e infine la completia-
+mo beatamente e ne fruiamo in eterno con gaudio, per 
+mezzo di quella Pietra Angolare e miracolosa, celeste 
+e fondata dall'eternità, Gesù Cristo, che con te, Dio 
+Padre, insieme allo Spirito Santo, vero Dio, in una in-
+dissolubile divina essenza, impera e regna, triunico Dio, 
+sommamente lodato nei secoli sempiterni. 
+Così sia. 
+Vi ho meditato a lungo, mentre riflettevo su 
+questi anni di lavoro e di studio, sulle mie incom-
+prensioni, sui vostri insegnamenti, su quello che 
+potrei dire a chi si inoltrasse su questa via. 
+C'è un avverbio curioso nel latino originale, 
+moderate, che ho tradotto: con misura. Mi sembra 
+un atteggiamento di quieta prudenza, tanto diver-
+so da quello con cui ho incominciato. Forse que-
+sto si potrebbe insegnare all'inizio: la necessità di 
+non avere fretta, di non essere avidi, nemmeno di 
+ conoscenza, nemmeno di amore. Ogni cosa ha il 
+suo tempo, e il Tempo vero non passa, arriva. 
+In realtà siamo così lenti, che una sola vita non 
+basta per chiudere il cerchio delle transmutazioni 
+necessarie al compimento dell'Opera. Quando ini-
+ziamo il cammino passeggiamo sulle nostre stesse 
+orme, ripercorriamo sentieri già visti, talvolta ripe-
+tiamo gli stessi errori, da cui è tanto difficile libe-
+rarsi. 
+Mitezza, e specialmente pazienza, sono prere-
+quisiti indispensabili. Specialmente pazienza. Per 
+un paradossale gioco della legge ineluttabile che ci 
+sfugge, eppure regge ogni cosa, tutto viene dato a 
+chi ha già: la Pace è data ai pacifici, agli altri sarà 
+tolto anche quel poco che ne possiedono. 
+Continuo a scoprire l'infinita ricchezza della 
+semplicità: la verità è semplice, come la natura, si è 
+detto, aggiungendo: e non bisogna dirla che alle 
+persone per bene. 
+Vago tranquillo, lasciandomi trasportare da 
+questi pensieri, nella mia pacifica attesa, senza 
+ansia, scrutando il Velo e sperando che si squarci 
+senza dolore. Talvolta mi faccio accarezzare dai 
+versi di un poeta alchimista cinese di tanti, tanti 
+secoli fa: 
+ Se tu mi chiedessi, con aria quasi di scherno, 
+perché vivo nascosto fra i verdi monti, 
+io ne sorriderei piano piano, 
+l'anima mia è serena, caro amico, 
+i fiori di pesco seguono l'acqua che scorre, 
+vi è un altro cielo e un'altra terra 
+al di là del mondo degli uomini. 
+Rispettosamente. 
+ UNDICESIMA RISPOSTA 
+Caro studioso, 
+cerca la rettitudine, e non un miracolo perché il 
+tuo Dio chiede rettitudine e il tuo sé chiede un 
+miracolo, che è un segreto di cui molti non sono 
+mai stati memori. 
+Si può accusare la propria fede quando non si 
+vedono miracoli, perché la saggezza non serve, 
+non rivela potenza in caso di rettitudine, e non dà 
+il piacere di un miracolo. 
+Sono stato in semitotale isolamento, studiando 
+fotocopie di antichi manoscritti dei nostri Imam. 
+Ora partirò per Al-Najaf Al-Ashraf in Iraq per 
+incontrare alcuni studiosi e per vedere alcuni 
+manoscritti di comune interesse sulla disciplina 
+mistica. 
+Sarà un viaggio di due anni. 
+La pace sia con te. 
+ Manoscritto alchemico arabo. 
+b l ^ s l i p p i r a 
+ì 
+k 
+I 
+A 
+' 
+>• ì 
+A 
+il Li è è ; 
+L I 
+ POSTFAZIONE 
+Il piccolo epistolario si chiudeva così, bruscamen-
+te. In fondo, ho ancora trovato un foglio di appun-
+ti. Conteneva alcune brevi frasi e un disegno, li 
+riporto qui senza cercarne spiegazione. 
+Del misterioso filosofo alchimista non si è avuta 
+più traccia. La villa è stata venduta, il contenuto 
+disperso. 
+In paese è rimasto comunque il ricordo del curio-
+so personaggio, ne è nata qualche leggenda. Corre 
+voce che si sia visto qualche volta vagare per il paese, 
+a tarda sera, un uomo che gli somiglia, anche se di età 
+decisamente più giovane. Scende da una grossa mac-
+china nera, cammina assorto per le vecchie stradine 
+che si affacciano a un laghetto, resta fermo a fissarne 
+le acque, poi riparte evitando qualunque incontro. 
+Le frasi del foglio, scritte frettolosamente, 
+dice-
+vano. 
+Una sola cosa, una sola via, un solo vaso, una sola 
+disposizione. 
+ Chi saprà fare l'Opera col solo Mercurio, quello avrà 
+trovato la via regia. 
+.Dio ti dia grassezza di terra e rugiada dal cielo. 
+La pazienza è la scala dei filosofi, e l'umiltà la porta del 
+loro giardino, perché a chiunque persevererà senza 
+invidia e senza orgoglio, Dio farà misericordia. 
+Il disegno, con un piccolo cartiglio, chiudeva la 
+pagina, come chiude questo libretto affidato al de-
+stino. 
+ 

static/data/roberto_busa.txt

@@ -0,0 +1,951 @@
+IL NOSTROMO
+emmeciquadro
+123
+dicembre 2001
+123
+IL COMPUTER USATO BENE
+INTERVISTA A ROBERTO BUSA S.J.*
+a cura di Maria Cristina Speciani e Vittorio Sacchi
+Una vita lunga e feconda quella di padre Busa, il gesuita
+ottantottenne che è riconosciuto come il pioniere della
+linguistica computazionale. Usando il computer come
+nessuno aveva mai fatto prima, con pazienza, coraggio e
+ostinazione, ha approfondito il suo rapporto con l’infini-
+to riscoprendo sul fondo «la luce di Dio che illumina
+ogni uomo e lo chiama». Oggi la sua avventura continua
+prospettando nuove analisi dei fatti e nuove metodologie
+di ricerca per ottenere dalla tecnologia del computer
+tutte le sue potenzialità e metterle al servizio dell’uomo.
+Sono passati più di cin-
+quant’anni da quando incontrò
+Thomas Watson, il fondatore
+dell’IBM, convincendolo a rac-
+cogliere la sfida dell’analisi
+computerizzata del linguaggio
+di san Tommaso. Nello svilup-
+po del suo lavoro ha attraver-
+sato i principali nodi della rivo-
+luzione informatica. In partico-
+lare, come ha vissuto, a partire
+dal desiderio iniziale, il rappor-
+to tra ricerca e tecnologia? 
+È meglio che racconti un po’ di
+storia. Il mio sogno, quando sono
+diventato gesuita era di andare in
+missione, invece i superiori mi
+hanno chiesto di fare il professo-
+re di filosofia scolastica con spe-
+cializzazione in san Tommaso.
+Durante la guerra, dopo aver
+fatto il cappellano per un anno,
+mi hanno mandato a fare la libe-
+ra docenza alla Gregoriana e poi
+il Ph.D. Vi racconto la storiella
+della recluta che, ricevuto l’ordine
+«avanti marsc», non si ferma in
+attesa del contrordine; il sergente
+si dimentica di lui e due giorni
+dopo quello da Padova ha rag-
+giunto Chioggia e «segna il
+passo» davanti al mare in attesa
+di nuovi ordini. Io son quello: mi è
+stato dato l’ordine di studiare san
+Tommaso, son partito, mi sono
+rimboccato le maniche e non ho
+più abbandonato la filosofia.
+Anche se oggi troppa filosofia è
+una passerella di estetismi verba-
+li e non la ricerca della Verità.
+Mi venne l’idea di cercare nei
+testi di san Tommaso la docu-
+mentazione originaria e probato-
+ria delle affermazioni che chia-
+miamo filosofiche; così è nato il
+progetto dell’Index Thomisticus. 
+Il linguaggio mi ha messo a con-
+tar parole e mi sono reso conto
+che il nostro parlare, alle sue
+radici, non lo conosciamo anco-
+ra. Ho usato il computer come
+*Nato a Vicenza nel 1913,
+è tuttora in piena attività. Ha
+insegnato alla Pontificia
+Università Gregoriana, al-
+l’Aloisianum di Gallarate e
+all’Università Cattolica di
+Milano. Dal 1995 al 2000
+ha insegnato al Politecnico
+di Milano nell’ambito dei
+corsi di Intelligenza Arti-
+ficiale e robotica tenuti da
+Marco Somalvico. «1261
+momenti di pensiero distilla-
+ti» da questo corso sono
+stati pubblicati nel 2000 da
+ITACAlibri in Dal computer
+agli angeli.
+Autore di numerosissimi
+saggi. La sua opera fonda-
+mentale, l’Index Thomisti-
+cus, pubblicato tra il 1974 e
+il 1980 in 56 volumi e oggi
+disponibile anche su cd-
+rom, è il risultato della ela-
+borazione computazionale
+dei testi di san Tommaso e
+ha costituito la base di qual-
+siasi ulteriore ricerca di
+informatica linguistica.
+ IL NOSTROMO
+dicembre 2001 124
+emmeciquadro
+strumento che permette di
+andare più in profondità median-
+te l’osservazione statistica e pro-
+babilistica. E mi sono accorto
+che le parole non hanno confini
+precisi: sul fondo c’era la luce di
+Dio che illumina ogni uomo e lo
+chiama.
+Oggi molti pensano che con il
+computer si possano risolvere
+tutti i problemi. A suo parere,
+quali sono le potenzialità del-
+l’informatica dal punto di vista
+didattico ed educativo?
+Gli aspetti educativi dell’informa-
+tica linguistica sono legati alla
+possibilità di rendersi conto che
+c’è un «pensiero», una «espres-
+sione esteriore» e una «espres-
+sione interiore». 
+La mia impressione è che oggi
+troppa didattica è basata sulla
+memorizzazione: si concepisce il
+nucleo del pensiero umano
+come una banca di dati e allora
+l’obiettivo dell’apprendimento
+diventa sapere tutto. 
+Invece, i principi sono questi: le
+strutture dell’espressione scritta
+riflettono il fatto che c’è un pen-
+siero originario il quale può
+dominare la moltitudine delle
+cose perché le classifica, le riuni-
+sce e le esprime con le parole.
+C’è un pensiero la cui caratteri-
+stica è di non reagire soltanto
+allo stimolo che c’è, ma anche e
+soprattutto agli stimoli che non ci
+sono ancora o non ci sono più.
+Per esempio: se si iscrive un
+bambino a scuola è perché si
+pensa che tra dieci anni, che
+non ci sono oggi, questo bambi-
+no avrà bisogno di avere un
+lavoro. E i nostri desideri punta-
+no sempre su quello che non
+c’è, su quello che non si ha (l’uo-
+mo è l’unico animale che ha
+inventato le distillerie!). In questo
+senso, il linguaggio, soprattutto il
+linguaggio scritto, non è una
+ripetizione continua, ma la crea-
+zione di architetture sempre
+nuove. 
+L’espressione esteriore è quella
+che noi chiamiamo realtà virtua-
+le: un’immagine non nel senso
+stretto della parola, iconico, ma
+immagine come segno e simbo-
+lo i quali vengono fatti sussistere
+in un altro soggetto che non è
+l’uomo che le pronuncia. Per
+esempio, la musica della marcia
+trionfale dell’Aida, creata dalla
+mente di Verdi, esiste per conto
+suo, ma sussiste oggi in un’or-
+chestra, domani in un’altra. 
+C’è anche una espressione inte-
+riore: vuol dire che le frasi che si
+pronunciano sono costruite
+prima dentro di noi e poi «buttate
+fuori» mediante la voce. Ma
+come si costruisce l’espressione
+dentro di noi è ancora terra sco-
+nosciuta. 
+Può fare un esempio?
+Lo spiego con questa storia.
+All’inizio degli anni Cinquanta,
+alcuni anni dopo che avevo
+cominciato, è nata la traduzione
+automatica (al MIT si pubblicava
+allora lo MT
+Mechanical
+Translation). Il Penta-gono
+aveva finanziato tutti i centri che
+si offrivano di lavorare sulla tra-
+duzione dal russo all’inglese e io
+avevo collegato il gruppo di
+Leon Dostert e Peter Toma di
+«Agli inizi l’obiettivo primo
+erano 12 milioni di schede
+perforate con stampato sul
+dorso un contesto di 11
+righe. Ne sarebbe risultato
+uno schedario unico di 90
+metri di fronte, 1,20 di altez-
+za e 1 di profondità: peso
+complessivo 500 tonnellate.
+Dopo che ne ebbi perforato
+sei milioni, la misericordia
+del Signore ha fatto inven-
+tare agli uomini i nastri
+magnetici. [...] Ebbi da allo-
+ra in lavorazione un parco
+di 1800 nastri magnetici, di
+2400 piedi cioè 800 metri
+ciascuno: erano circa 1500
+kilometri di nastro, presso a
+poco la distanza tra Milano
+e Palermo o tra Parigi e
+Lisbona. [...] Per cui la
+prima epoca fu quella delle
+500 tonnellate di schede, la
+seconda fu quella dei 1800
+nastri magnetici. Terza
+epoca è ora quella di 1 solo
+cd-rom.»
+(Dal computer agli angeli,
+pp. 25-26)
+ IL NOSTROMO
+emmeciquadro
+125
+dicembre 2001
+Georgetown, università dei miei
+confratelli di Washington DC con
+l’Euratom di Ispra per tradurre
+abstract di biochimica e biofisica
+russi: per questo abbiamo perfo-
+rato un milione di parole in cirilli-
+co. Anche il progetto su san
+Tommaso, a cui lavoravo sui
+computer dell’Euratom, era lega-
+to a questa iniziativa. Alla metà
+degli anni Sessanta, a seguito
+del famoso rapporto ALPAC, il
+Pentagono improvvisamente
+sospese i finanziamenti procla-
+mando l’insuccesso della tradu-
+zione automatica; tale insucces-
+so era dovuto non a mancanza
+di velocità o di memoria dei com-
+puter, ma alla mancanza di infor-
+mazioni filologiche sul nostro par-
+lare, delle quali il computer ha
+bisogno.
+La «vecchia» filologia è basata
+solo sulla campionatura, sulla
+massa dei grandi numeri e delle
+parole che noi cerchiamo; questo
+non è sufficiente per il computer
+che ha bisogno di avere dati in
+percentuale molto approssimati e
+formalizzati, cioè traducibili in
+byte. Per far questo è necessario
+che sia chiaro in base a quali
+logiche si parla, logiche che si
+manifestano con la morfologia,
+con la sintassi e con il lessico.
+Dal computer, dal mostro d’ac-
+caio, dalla tecnologia usata per
+l’industria dell’informazione viene
+la richiesta che si conosca
+meglio in base a quali elementi e
+a quali logiche si parla. Se l’uma-
+nesimo è la scienza dell’espres-
+sione umana in tutte le sue mani-
+festazioni, allora il computer
+esige che noi uomini abbiamo un
+umanesimo più spinto. 
+Dunque il computer chiede
+all’uomo di conoscere meglio
+se stesso. Allora quali posso-
+no essere i vantaggi nell’impa-
+rare attraverso lo strumento
+informatico piuttosto che con
+un altro supporto? 
+Studiare con il computer, in
+realtà è comunicare: dal mio
+osservatorio comunico dei bit di
+informazione agli altri. Quando si
+tratta di studiare occorre introdur-
+re due elementi: raccogliere dati
+di fatto, il maggior numero possi-
+bile, dalla realtà, mediante l’os-
+servazione; poi questi dati vanno
+sintetizzati. Questa elaborazione
+è il lavoro specifico del pensiero,
+ma per sintetizzare bisogna
+prima di tutto classificare. 
+In questo senso io ho fatto due
+ricerche originali, che non ho tro-
+vato in nessuna parte: la prima è
+sulla eterogeneità delle parole e
+la seconda sui segni grafici delle
+parole. 
+La ricerca sull’eterogeneità
+delle parole in sanTommaso
+durò ben otto anni, dal 1983 al
+1991. Quali furono i criteri del
+lavoro? E quali i risultati?
+Si trattava di classificare le parole
+secondo «tipi di semanticità»,
+ossia secondo le diversità dei
+rapporti tra segno e significato. E
+richiese alcune migliaia di ore-
+uomo e molta pazienza anche
+solo per far emergere il criterio
+per distinguere le categorie delle
+parole. Perché i rapporti tra signi-
+ficante e significato sono diver-
+sissimi in relazione alla semanti-
+cità delle parole. 
+ IL NOSTROMO
+dicembre 2001 126
+emmeciquadro 126
+Porto qualche esempio.
+Ci sono i nomi deittici, come per
+esempio i due pronomi personali
+«io» e «tu». Essi hanno come
+significante due lettere, rispetti-
+vamente i-o e t-u, ma il significa-
+to di queste parole è che sono
+segni della conoscenza di una
+presenza; non sono concetti,
+perché un concetto prevede una
+formula. Ma quando io dico «io»
+la presenza è diversa da quando
+un altro dice «io». Pensate,
+anche il Signore, che pure ha
+inventato padre Busa, non può
+dire di essere padre Busa.
+Un'altra categoria sono i nomi
+propri; essi sono nomi etichetta e
+indicano un oggetto preciso; non
+esprimono che cosa sia, ma
+anch’essi sono la conoscenza di
+una singolarità. Per esempio,
+sentendo qualcuno che chiama
+Cicci si sa che c’è un Cicci ma
+non si sa se sia un gatto, una
+bambina o un ragazzo. Poi ven-
+gono i nomi di oggetti (un tavolo,
+un cavallo) che gli antichi chia-
+mavano sostanza; sono il sog-
+getto e il complemento oggetto di
+quei verbi che significano attività
+e produzione. Anche questi sono
+nomi etichetta. Quando dico
+tamarindo so che voglio dire una
+certa pianta o una certa bibita,
+anche se non dico niente delle
+sue proprietà. Poi vengono final-
+mente gli aspetti delle cose:
+dimensioni, forme, temperatura,
+peso, movimento eccetera, che
+solitamente chiamiamo aggettivi.
+Son quelli in cui sta tutta la cultu-
+ra perché sono vere e proprie
+immagini mentali, veri e propri
+concetti. Poi vengono le parole
+che esprimono relazioni e corre-
+lazioni cominciando con le pre-
+posizioni; infine ci sono parole
+vicarie come i pronomi relativi e
+simili.
+Ho fatto il censimento di tutte
+queste parole. Negli 11 milioni di
+parole dell’Index Thomisticus
+(siccome Dio l’ho messo tra i
+nomi propri), con tutti gli altri
+nomi propri arriviamo al 3%; gli
+oggetti e le cose arrivano al 6-
+8%; la maggior parte dei restanti
+sono le parole di correlazione. 
+A questo proposito, mi ricordo
+che in un congresso un gruppo
+di scienziati sosteneva che metà
+delle parole di san Tommaso
+esprimessero le realtà religiose
+invisibili. Invece il nome Cristo
+non è un nome invisibile; è invisi-
+bile come è invisibile Socrate. Le
+realtà invisibili sono poche e
+sono alla radice del cosmo: Dio,
+gli angeli, i demoni e i nostri
+morti. Ma invisibili sono anche le
+forze di base della natura, dalle
+forze cosmiche di base (l’elettri-
+cità, la gravità, le onde hertziane)
+ai loro programmatori che sono
+gli angeli, i software del Signore
+Dio loro creatore. Questo c’è in
+san Tommaso, con altre parole
+naturalmente.
+Invece, come ha strutturato la
+ricerca sui segni grafici?
+Avevo 11 milioni di parole latine;
+riepilogate secondo «forme» di
+parola graficamente diverse
+erano circa 150 000; poi avevo
+«lemmatizzato» ciascuna di esse
+trovando 20 000 lemmi. Il lemma
+è quella parola che nei vocabola-
+ri rappresenta tutte le proprie
+flessioni secondo una certa unità
+ IL NOSTROMO
+emmeciquadro
+127
+dicembre 2001
+127
+che io chiamo unità lessicale
+che con le flessioni viene arric-
+chita, ma non contraddetta (il
+lemma è come il corpicino della
+bambola Barbie e le flessioni
+sono come gli abitini che le si
+mettono intorno). 
+Ho preso tutti i lemmi, li ho divisi
+in un massimo di tre segmenti
+(iniziale, centrale e finale), in
+qualche senso a caso, senza
+badare al significato e meno
+ancora alla glottologia, alle deri-
+vazione o alle trasformazioni, ma
+proprio graficamente. Una stessa
+stringa di quattro caratteri si trova
+ripetuta in tante parole all’inizio,
+come iniziale assieme ad altre
+stringhe diverse, ma anche in
+posizione centrale o finale. Ho
+fatto una classificazione e la mia
+sorpresa è stata che 11 milioni di
+parole sono la combinazione di
+un massimo di 1 500 stringhe
+diverse di caratteri. Solo 1 500. 
+Naturalmente ci sono le stesse
+stringhe con significati diversi. 
+Nel suo libro Dal computer agli
+angeli auspica che la statistica
+linguistica tenga conto della
+eterogeneità delle parole di un
+testo e di quella che lei defini-
+sce «doppia struttura del lessi-
+co». Può spiegare il significato
+di questa espressione?
+Da sempre è risaputo che quan-
+do si parla o si scrive ci sono
+poche parole diverse, di solito
+corte, moltissimo ripetute. Poi ci
+sono tante parole, relativamente
+poco ripetute, tra le quali tutte le
+parole lunghe. Questo l’ho sem-
+pre riscontrato e oggi li chiamo i
+due emisferi del lessico.
+Il primo lessico, quello delle paro-
+le frequenti e brevi, le particelle
+che a scuola venivano chiamate
+grammaticali, oggi sono definite
+dagli inglesi function words e
+anche close class words perché
+non aumentano. Esse sono con-
+trapposte a quelle di contenuto,
+chiamate content words e anche
+open class words perché cam-
+biano e crescono. Le prime sono
+quelle che esprimono la logica
+con cui ciascuno cerca di parla-
+re. Le seconde sono quelle che
+specificano la cultura, cioè i con-
+tenuti che specificano il messag-
+gio. I due emisferi sono questi:
+la logica e la cultura. E tra le per-
+sone non c’è differenza nella
+logica di base, ma nella cultura.
+Io non ho lavorato solo le parole
+di san Tommaso, ma altrettanti
+milioni di parole in altre 22 lingue
+e alfabeti diversi: i rotoli di
+Qumrân, che sono in alfabeto
+ebraico ma in tre lingue (ebraico,
+aramaico e nabateo), tutto il
+Corano in arabo, il finnico, il cirilli-
+co, il boemo e ovviamente tutte
+le lingue europee e il greco; le
+ultime sono state l’albanese e il
+giorgiano e poi l’alfabeto foneti-
+co. In tutte queste cose ci sono i
+due emisferi del lessico. 
+Nell’oralità non ho fatto calcoli,
+perché i media espressivi sono
+tanti e perché nell’oralità il lin-
+guaggio è ridotto al minimo. Per
+esempio, se ordino una birra e
+dico «cameriere me ne porti
+un’altra», in questo caso «altra»
+è la birra; invece, se avessi ordi-
+nato una zuppa, «altra» avrebbe
+un altro significato. 
+Invece il linguaggio educato è
+quello scritto.
+Pagine dei Rotoli di Qumrân
+ IL NOSTROMO
+dicembre 2001 128
+emmeciquadro
+In questa direzione, la critica
+di un libro si fa al suo interno.
+Di fronte a un libro non biso-
+gna mettersi con l’idea di con-
+futarlo, ma vedere se quello
+che dice è coerente con la
+logica con cui lo dice.
+Recentemente mi hanno chie-
+sto perché lavorare su san
+Tommaso e non su un testo
+moderno. Trent’anni fa mi
+hanno invitato a Mosca per
+lavorare sui testi di Lenin con
+lo stesso metodo. E ho prova-
+to a farlo, nei ritagli di tempo,
+anche sul libro di Jacques
+Monod (Il caso e la necessità)
+e poi su quello di Stephen
+Hawking (Dal big bang ai
+buchi neri) e in passato l’ave-
+vo fatto con il behaveourista
+Skinner. Si riesce a vedere il
+momento in cui i testi di un
+autore sono illogici: non per-
+ché 
+contraddicono 
+san
+Tommaso o san Bonaventura,
+ma perché sono illogici in se
+stessi. 
+Recentemente i giornali
+hanno parlato di lei definen-
+dola «informatico di scienze
+umane», invece ci sta
+facendo una riflessione sul-
+l’uomo. Queste categorie
+valgono in tutti gli ambiti?
+Anche nel fare scienza?
+Facciamo riferimento ai due
+emisferi. Nel primo emisfero,
+quello della logica, si vede la
+luce di Dio che illumina ogni
+uomo. In tutti i congressi
+sostengo che tutte le anime e
+le intelligenze non vengono
+per evoluzione: le anime sono
+fatte tutte dal Signore Dio, una
+per una. È un paradosso, ma
+utile per chiarire: non ci vuole
+meno di Dio tutto intero per
+fare un’intelligenza d’uomo,
+per fare uno spirito. La luce di
+Dio è la logica e la logica sono
+le leggi dell’essere. 
+Io vedo tre livelli di logica.
+Quella che si insegna all’uni-
+versità, la logica formale, è il
+rapporto tra contenente e
+contenuto, fra tutto e parte. 
+Un’altra logica, che non viene
+così studiata, è quella del rap-
+porto tra autore e opera, tra
+attivo e passivo che è un rap-
+porto strano, perché è a
+senso unico: nessun figlio è
+padre del proprio padre, nes-
+suna statua è l’autrice del
+proprio scultore. Tutti lo
+sanno: chi ha scritto un’opera
+va dalla SIAE a farsi dare la
+percentuale e non dice mai
+che la sua opera è fatta per
+caso. 
+Il terzo livello è quel rapporto
+tra pensiero ed espressione
+che è il principio di non con-
+traddizione. Come dice il
+nome, la contraddizione ha a
+che fare con il dire, cioè con
+l’espressione. Si riesce sem-
+pre a pronunciare frasi con-
+traddittorie: per esempio «qui
+ora piove» e «qui ora non
+piove», ma nessuno riesce a
+pensare che ambedue siano
+contemporaneamente vere,
+né che ambedue siano con-
+temporaneamente 
+false.
+L’espressione non deve con-
+traddire il proprio pensiero: il
+che conchiude alla immoralità
+intrinseca della menzogna.
+ IL NOSTROMO
+emmeciquadro
+129
+dicembre 2001
+Perché oggi nel mondo
+della cultura questi livelli di
+logica sono più spesso
+negati che affermati? Per-
+ché nella comunicazione,
+nel lavoro, nella scuola,
+nella scienza, ci si basa di
+più sul suscitare sensazioni
+che non sulla logica? 
+Direi ignorati, moltissimo igno-
+rati e poche volte negati. Nei
+libri di logica non ho mai tro-
+vato il rapporto attivo/passivo,
+ma sempre il rapporto ve-
+ro/falso e poi contenente/con-
+tenuto. Ai miei studenti di filo-
+sofia, preoccupati di aver letto
+una gran quantità di autori,
+dicevo: basterebbe sapere la
+metà di quel che sappiamo
+ma saperlo dire meglio il dop-
+pio se no è esibizione di quel-
+lo che abbiamo in magazzino
+nella memoria. 
+La storia del linguaggio e della
+cultura è in fondo storia di
+anime, storia del colloquio
+segreto che abbiamo con Dio.
+Ed è una storia che ha più
+avventure di quelle di San-
+dokan e delle Twin Towers. 
+Perché segreto?
+Perché sta nel profondo della
+logica, perché la logica è data
+per arrivare a capire il perché
+di tutto e perché nel vocabola-
+rio di tutte le persone c’è la
+parola «prima» e anche la
+parola «sempre». Sotto que-
+sto luccichio e questo mare di
+parole c’è la storia delle anime
+nel tempo: dall’eternità verso
+l’eternità. Si arriva dunque alla
+logica come prima luce dell’a-
+nima, quella che porta il
+tempo all’eternità, dall’eternità
+all’eternità. Un mio amico arti-
+giano mi ha detto che la mag-
+gior parte delle persone non
+sa dove va, ma ci sta andando
+di corsa. E oggi è così anche
+per molta filosofia professio-
+nale: dalla ragion pratica fino
+alla new age, certa filosofia è
+la maschera della logica.
+Nel mese di ottobre, al
+Circolo della Stampa di
+Milano, ha presentato il pro-
+getto a cui sta lavorando.
+Ce ne illustra i punti chiave? 
+Il progetto si chiama Lessico
+Tomistico Biculturale (LTB). 
+Lo spunto è venuto dall’analisi
+dell’espressione 
+di 
+san
+Tommaso ratio seminalis, che
+era l’antico stoico λογοσ
+σπερµατικοσ, l’anima mundi
+che Virgilio ha messo in versi
+latini molto belli. Sant’Agosti-
+no l’ha introdotto nel pensiero
+cristiano spiegando il Genesi
+e a conseguenza di questo il
+pensiero cristiano è stato evo-
+luzionista, non nel senso
+magico di oggi, fino al Rina-
+scimento avanzato. Ho e-
+saminato questa frase, che
+san Tommaso ha usato dieci o
+quindici volte più di sant’A-
+gostino.con il metodo cui ac-
+cennerò dopo e mi è risultato
+chiaro che san Tommaso,
+quando scriveva ratio semina-
+lis (che ho trovato sempre tra-
+dotto come ragione seminale)
+aveva in mente quello che
+abbiamo in mente noi quando
+ IL NOSTROMO
+dicembre 2001 130
+emmeciquadro
+parliamo di «programma geneti-
+co». Se sostituite nelle frasi di
+san Tommaso questa espres-
+sione, il contesto si accende
+come una lampadina. Non che
+lui conoscesse il DNA, perché
+ovviamente non c’erano gli stru-
+menti di indagine, ma lui sapeva
+che doveva esserci un program-
+ma genetico che partiva da Dio
+creatore e si esprimeva in ogni
+individuo. Poi c’erano le forze di
+base della natura; non dice quali
+sono, ma dice che ci sono. Per
+me sono luce, onde hertziane
+gravità eccetera, queste forze
+che sono a monte dell’evoluzio-
+ne, che la generano. 
+Quando parte il progetto?
+Il lessico di san Tommaso è
+enciclopedico ed è una sintesi di
+quaranta secoli di civiltà medi-
+terranea: comincia con Abramo,
+frutto della civiltà e della cultura
+mesopotamica, circa 3000-3500
+anni prima di Cristo, poi c’è il
+pensiero greco, il pensiero
+romano, il pensiero arabo e tutto
+il pensiero cristiano; di questi
+quaranta secoli, dodici sono di
+civiltà cristiana. Adesso che ho
+tutto il suo lessico, prendo in
+esame san Tommaso non per
+quello che lo distingue dagli altri
+autori analoghi, ma per quello
+che ha in comune con tutti.
+Allora, si tratta di prendere le
+sue parole una per una, aven-
+dole già divise per categorie
+semantiche, risalire da queste
+parole ai concetti che esprime-
+vano allora (nella cultura del
+1200), venire oggi (nel 2000)
+agli stessi concetti e da questi
+discendere alle parole che li
+esprimono e darne così la tradu-
+zione in diverse lingue. Per que-
+sto il progetto si chiama bicultu-
+rale.
+Sono già trent’anni che lavoro in
+questo senso con il metodo che
+spiegherò e ho analizzato deci-
+ne di migliaia di contesti. 
+Ci sono parole come «esperien-
+za» e «espressione» che hanno
+circa lo stesso valore che i nostri
+espressione ed esperienza. 
+Ci sono altre parole invece che
+hanno significati molto maggiori.
+Per esempio, virtus-virtutis non
+si può tradurre sempre con
+«virtù» perché virtus ha tutto il
+vocabolario dell’energia, forza,
+professionalità, potenza. E
+anche la parola ordo-ordinis,
+che ho analizzato in 10 000 con-
+testi, non può essere tradotta
+sempre con «ordine»: nel latino
+di san Tommaso non voleva
+ancora dire precetto, comando
+e neppure in Dante Alighieri.
+Ordo-ordinis esprime tutto il
+vocabolario della organizzazio-
+ne, pianificazione, progettazio-
+ne, programmazione, tutti i con-
+cetti di struttura e sistema, quelli
+di tassonomia e classificazione
+oltre a indicare categorie profes-
+sionali. Poi spiritus: tante volte è
+spirito, altre volte è spinta,
+impulso, pulsione oltre che spiri-
+to nel senso di spirituale o
+anche fantasma. 
+Allora ci spiega il metodo che
+propone?
+Il metodo. Prendo, di una paro-
+la, tutti i contesti, tutte le frasi
+che la contengono; su queste
+ IL NOSTROMO
+emmeciquadro
+131
+dicembre 2001
+frasi inserisco i codici delle cor-
+relazioni sintattiche, elementari
+e dirette; in parole correnti i
+codici che specificano l'analisi
+grammaticale e logica di questa
+parola, frase per frase. 
+Questo è un lavoro da «sgobbo-
+ni» però è la forma profonda e
+solida di pensare. Mi aspetto che
+qualcuno mi dica che è puerile
+ma ho già la risposta pronta:
+provi a farla, anche solo su 100
+frasi, non su 10 000 come le ho
+fatte per ordo o su 20 000 per
+spiritus e si accorgerà della diffi-
+coltà. Perché il pensiero e l’e-
+spressione sono disparati e il
+pensiero è multidimensionale,
+eccentrico e a-centrato: non si
+riesce mai a trovare i confini di
+un concetto, se ne trova subito
+un altro; per questo parlo di unità
+lessicali più che di unità concet-
+tuali. Invece l'espressione è
+sequenziale, tabulata come le
+battute di una musica, però «liofi-
+lizza» un concetto.
+In periferia, in tutto il mondo
+dovremo trovare persone che
+sappiano il latino, che siano
+sgobboni, che non disdegnino
+gli antichi. Se hanno queste
+qualità possono partecipare al
+progetto. A ognuno viene data
+una parola su cui devono esse-
+re eseguite tutte le sintesi di cor-
+relazioni con una cascata di pro-
+grammi monofunzione: non un
+programma come quello per gli
+stipendi che fa tutto insieme in
+un colpo solo, perché questa è
+ricerca. Dai collegamenti sintatti-
+ci di ogni parola con i verbi di cui
+è soggetto o complemento, ver-
+ranno fuori i suoi significati.
+Finora a me sono venuti fuori.
+Poi ognuno deve fare un elenco
+di questi significati nella propria
+lingua: inglese, spagnolo, tede-
+sco eccetera..
+Poi i risultati vengono inviati a
+Roma dove, per prima cosa, un
+comitato certifica la qualità del
+lavoro. Questo è indispensabile.
+Poi, all’interno di seminari tra
+esperti di vari paesi e lingue,
+bisogna esaminare i significati di
+questi concetti per tradurli nelle
+diverse lingue e nelle diverse
+culture contemporanee. Tra l’al-
+tro, chi fa l’esame sintattico di
+una voce deve analizzare le
+desinenze: per esempio deve
+dire quando veni è imperativo,
+quando è passato remoto ecce-
+tera, quando rosae è genitivo,
+ottativo, eccetera; io segnalo
+solo, in una nota, se la parola è
+omografa. Questo progetto è la
+continuazione di tutto quello che
+ho fatto finora. Ci lavoro da
+quindici anni e ora è nato a
+Roma un consorzio tra sei uni-
+versità: Gregoriana, Salesiani,
+Pontificia Università
+Gregoriana, Roma 
+ IL NOSTROMO
+dicembre 2001 132
+emmeciquadro
+Domenicani, Opus Dei, Servi
+di Maria, Laterano, più la
+Sapienza statale di Roma
+con l’istituto di Tullio Gregory.
+L’iniziativa si è sviluppata
+piano piano e adesso è
+patrocinata da due gruppi. Il
+primo con Antonio Fazio,
+Hans Tietmayer e Michel
+Camdessous e anche i due
+cardinali Re e Tettamanzi. Il
+secondo è la CAEL (Compu-
+terizzazione delle Analisi
+Ermeneutiche e Lessicolo-
+giche), continuazione del
+CAAL (Centro Automazione
+Analisi Linguistica) che per
+trent’anni con la IBM ha
+finanziato l’Index Thomisti-
+cus.
+Nel mese di dicembre i due
+gruppi si incontreranno per
+definire la forma di collabora-
+zione allo stesso scopo. Si cer-
+cheranno i finanziamenti con
+l’intenzione di spendere il
+meno possibile. Perché, diver-
+samente da quanto avviene di
+solito (prima i soldi, poi una
+sede pomposa, poi il lavoro),
+noi abbiamo cercato prima l’i-
+dea, poi il lavoro e i soldi sono
+sempre venuti. I progetti son
+come semi che bisogna gettare
+e piano piano cresceranno.
+Un’altra importante novità nel
+metodo di lavoro è la speri-
+mentazione di una collabora-
+zione internazionale tra diverse
+università attraverso un lavoro
+in equipe in rete (e-mail, tele-
+conferenza) e i loro sviluppi. A
+Roma c’è già un piccolo nucleo
+di persone che sarà il centro di
+questo lavoro in rete. 
+Per concludere, vorrei ripetere
+che l’informatica e i computer
+sono un dono di Dio che Lui ha
+preparato dagli inizi del mondo.
+Oggi purtroppo in questo
+campo c’è una grande confu-
+sione: primo ne parlano troppo
+quelli che non ne sanno,
+secondo ne parlano i sognatori
+facili, che desiderano far dena-
+ro velocemente.
+Invece dobbiamo dire che le
+potenzialità dell’informatica
+non sono esaurite, stanno
+ancora «cabrando». Gli aero-
+plani ci hanno messo 100 anni
+a perfezionarsi, queste cose
+ce ne metteranno altrettanti,
+piano piano. 
+Per contribuire solidamente a
+questo sviluppo basta che
+ognuno cominci a fare il poco
+che è utile a lui: questo fa cre-
+scere vitalmente le strutture
+nuove. Però bisogna mettersi
+a lavorare su una linea preci-
+sa e definita. 
+Volete un ultimo aforisma? 
+Il computer può essere usato
+bene per il bene, può essere
+usato male per il bene e può
+essere usato bene anche per il
+male.
+v
+«Siccome il computer è
+figlio dell’uomo e l’uomo è
+figlio di Dio, allora il Signore
+Dio guarda il computer
+come un nonno guarda i
+suoi nipotini. Guai a parlar-
+ne male e a usarlo male.»

static/help0.html

@@ -0,0 +1,201 @@
+<div class="text">
+    <p class="center"> Comandi barra superiore </p>
+    <div>
+        Pulsante Menu
+        <p> Apre/chiude il Menu comandi </p>
+    </div>
+    <div>
+        Uploa dFiles
+        <p>
+            Fa l'upload di un file locale. Sono accettati i file pdf e txt.
+            Controlla se il file è in archivio, per non sovrascriverlo.
+        </p>
+    </div>
+    <div>
+        Upload Dir:
+        <p>
+            Per fare l'upload dei files di una dri. Sono accettati i files pdf e txt.
+            I file in archivio con lo stesso nome non vengono sovrascritti.
+        </p>
+    </div>
+    <div>
+        Log:
+        <p>
+            Attiva/Disattiva la visualizzazione del Log.
+            Nel Log sono visualizzate le query con le dimensioni delle parti di documento analizzata.
+        </p>
+    </div>
+
+    <!--  -->
+    <hr>
+    <!--  -->
+    <div>
+        <p class="center"> Comandi lato destro in alto: </p>
+    </div>
+    <div>
+        Copia:
+        <p> Copia il testo dell'output negli appunti. </p>
+    </div>
+    <div>
+        Apri:
+        <p>
+            Visualizza il testo in una finestra più grande.
+        </p>
+    </div>
+    <hr>
+    <!--  -->
+    <div>
+        <p class="center"> Comandi lato destro in basso: </p>
+    </div>
+    <div>
+        Documeti => RAG => Contesto => Query:
+        <p>
+            Input per la query da utilizzare per la elaborazione RAG.
+            Ogni documento in archivio è diviso in parti compatibili con l'ampiezza della finestra
+            di input sel Model utilizzato.
+        </p>
+        <p>
+            Per ogni parte esegue una query utilizzandola
+            per estrarre informazioni/concetti pertinenti alla stessa.
+
+        </p>
+        <p>
+            Il risultato di ogni query è archiviato nella memoria locale.
+        </p>
+        <p>
+            All fine della sequenza di elaborazioni esegue uan query che produce
+            un contesto riepilogativo delle risposte archviate.
+        </p>
+        <p>
+            Infine esegue la query utilizzzando il conesto creato e visualizza la risposta ella finestra di output.
+        </p>
+    </div>
+    <div>
+        Contesto => Query:
+        <p>
+            Input per query che utilizzano il contesto creato con l'elaborazione RAG.
+            Inizia una conversazione.
+        </p>
+        <p>
+            La conversazioe ha senso relativamente all'elaborazione RAG se ogni query è una variazione / approfondimento della query iiziale.
+        </p>
+    </div>
+    <div>
+        Cancela Conversazione:
+        <p>
+            Cancella la storia della conversazione attiva.
+            Non vengoo cancellati i dati dell'laborazione RAG
+        </p>
+    </div>
+    <!--  -->
+    <hr>
+    <!--  -->
+    <div>
+        <p class=" center"> Comandi del Menu: </p>
+    </div>
+    <div>
+        README
+        <p>
+            Presenta una spiegazione della implemntazione della
+            tecnologia RAG utilizzata.
+        </p>
+    </div>
+    <div>
+        Risposta:
+        <p> Visualizza lq risposta ottenuta alla fine della elaborazione RAG </p>
+    </div>
+    <div>
+        Query iniziale:
+        <p> Visualizza lq query utilizzata per l'elaborazione RAG </p>
+    </div>
+    <div>
+        Elenco Risposte:
+        <p>
+            Visualizza l'elenco delle risposte per ogni parte documento utilizzata fino alla riposta che genera il contesto.
+        </p>
+    </div>
+    <div>
+        Contesto RAG:
+        <p>
+            Visualizza il contesto creato utilizzando le risposte elaborate.
+        </p>
+    </div>
+    <div>
+        Dati ARchviati:
+        <p>
+            Visualizza i ati in archivio e le lroro dimensioni:
+        </p>
+    </div>
+    <div>
+        Lista Documenti:
+        <p>
+            Visualizza la lista dei documenti achviati ed utilizzabili per l'elaborazione.
+        </p>
+    </div>
+    
+    <div>
+        Numero query:
+        <p>
+            Calcola le query necessarie per ogni documento e le Query totali,
+            necessaire per analizzare tutti i documenti caricati.
+        </p>
+    </div>
+    
+
+    <div>
+        Cancella Dati:
+        <p>
+            Cancella i dati delle elaborazion salvati nell'archivio.
+            NON cancella i documenti caricati.
+        </p>
+    </div>
+
+    <div>
+        Cancella Documenti:
+        <p>
+            Cancella i documenti caricati e tutti i dati archviati locamente.
+        </p>
+    </div>
+
+<!--  -->
+
+    <p class="center">Sequenza Comandi Interrogazione -Conversazione</p>
+    <div>
+        Archivia nella memoria locale  uno o più documenti:
+        <p>
+            Utilizza i dati di esempio per le prme prove.
+            Utilizza upload file o upload dir per i documenti da leggere dal tuo computer.
+        </p>
+    </div>
+    <div>
+        Digita uan query CHE SI RIFERISCA hai documenti archiviati.
+        <p>
+            La qury saraà utilizzata come crrtero di selezione di infoemazioni dai documenti archvitati.
+        </p>
+    </div>
+
+    <div>
+        Click sul bottone rosso in basso a destrai.DOcuento => RAG =>Contetso => QURY
+        <p>
+            Viene lanciata una sequenzaa di elaborazione per analizzare i documeti sulla base della query.
+            Se il log è attivo vedrai la sequnza di elaborazione. Il loro numero dipende dalle dimensioni dei documenti.
+            l menu puoi utilizzare il comando "Num Query" per vedere quante elaborazioni saranno fatte per ogi documento.            
+            Alla fine del proesso sarà visualizzata la risposta.
+        </p>
+    </div>
+
+    <div>
+        Click sul bottone verdo in basso a destrai. Contesto => Query
+        <p>
+            Inizia una comnversazione utilizzando le informazion precedentemnete raccolte dai documeti-
+            Puoi inviare domande successive  di approfondimento e chiarmento .
+            È FONDAMENTALE che le query siano approfondimenti e/o chairimenti della query iniziale.
+            In caso conrtario non si sfrutta il Contesto creato dall'elaborazione precdente.
+            Quindi per una query completamnete nuova (sempre relativa ai documeti archviati) è necessario inizare una nuova elaborazione.
+            Il comando cancella, oltre a cancellare il campo di input canella anche la sequnza query-risposte della
+            conversazione. NON cancell i dati dell'elaborazione iniziale.            
+        </p>
+    </div>
+
+
+</div>

static/help1.html

@@ -0,0 +1,59 @@
+<div class="text">
+    <pre>
+Un'implementazione innovativa della tecnica RAG per il Question Answering
+La tecnica RAG (Retrieval-Augmented Generation) è un approccio consolidato nel campo del question answering e della generazione di testo, che combina il recupero di informazioni pertinenti da fonti di dati con la generazione di testo basata su queste informazioni.
+Qui viene proposta una implementazione che introduce una variazione a questo paradigma.
+L'implementazione si basa su una sequenza di prompt appositamente progettati per guidare un modello di linguaggio generativo attraverso le diverse fasi della tecnica RAG.
+Questi prompt forniscono istruzioni dettagliate su come il modello deve seguire operazioni di recupero di informazioni, aumento delle informazioni recuperate e infine generazione di una risposta finale.
+La risposta finale diviene poi il contesto da inserire nel prompt per rispondere alla domanda.
+Un aspetto cruciale di questa implementazione è che lo stesso modello di aggio generativo svolge tutte le operazioni richieste, dall'analisi dei documenti di input al recupero di informazioni rilevanti, alla generazione della risposta finale.
+Questa caratteristica rappresenta una deviazione significativa rispetto alle implementazioni standard della tecnica RAG, che  prevedono utilizzo di moduli distinti per il recupero e la generazione.
+La sequenza di prompt proposta guida il modello attraverso le seguenti fasi:
+        
+1. Retrieval: Il modello analizza il documento di input e la domanda fornita, identificando e recuperando le informazioni e i concetti rilevanti per dare seguito alla domanda.
+        
+2. Augmentation: Successivamente, il modello integra le informazioni recuperate con eventuali risposte accumulate in precedenza, estraendo nuove informazioni rilevanti e organizzando in un elenco coerente, evitando ridondanze.
+        
+3. Generation: Infine, il modello utilizza l'insieme di informazioni rilevanti e non ridondanti per generare una risposta completa e concisa alla domanda dell'utente.
+        
+Questa implementazione offre diversi vantaggi.
+In primo luogo, sfrutta le capacità di un unico modello di grandi dimensioni i, evitando la necessità di moduli distinti specializzati per ogni fase.
+Inoltre, l'utilizzo di prompt espliciti può migliorare la controllabilità e la trasparenza del processo, consentendo di guidare il modello in modo più diretto.
+Naturalmente, come per qualsiasi approccio basato su modelli di linguaggio generativi, è fondamentale prestare attenzione alle questioni di affidabilità, correttezza e bias dei dati di addestramento.
+Rispetto ad una implementazione standard di RAG vii è la necessità di rilanciare l'elaborazione ad ogni domanda radicalmente nuova in quanto il contesto creato con le informazioni estratte dai documenti è definito sulla base della domanda.
+Invece nella versione standard RAG si usano gli incorporamenti delle informazioni estratte dai documenti in modo tale che tal informazioni vengono viste quasi come una estensione del Model e possono essere usate per domande diverse. 
+Quindi dal punto di vista utente le implementazioni RAG standard sono più efficienti; infatti l'implementazione proposta richiede per ogni nuova domanda  una sequenza di richieste che saranno utilizzabili solo per creare il contesto per la domanda iniziale e per una conversazione con domande simili. 
+Il vantaggio dell'implementazione proposta consiste nel fatto che può essere implementata completamente lato client senza bisogno di sviluppare alcun modulo sul server. 
+L’unica cosa che serve è un servizio servless come quello di HuggingFace o simile.
+Quindi rappresenta un'interessante prospettiva sull'applicazione della tecnica RAG in modo più integrato e controllato attraverso l'uso di prompt mirati.
+In conclusione, questa implementazione della tecnica RAG dimostra come le capacità dei modelli di linguaggio generativi di grandi dimensioni possano essere sfruttate in modi nuovi e creativi, potenzialmente aprendo la strada a ulteriori sviluppi nel campo del question answering e della generazione di testo.
+        
+Questa è la valutazione fatta da un LLM (comprensivo e gentile)
+        
+ La mia valutazione personale della tua proposta di implementazione della tecnica RAG, con un elenco di pro e contro:
+        
+Punti a favore (Pro):
+Semplificazione del processo: L'utilizzo di un unico modello di grandi dimensioni addestrato su vasti corpus di dati semplifica notevolmente l'architettura complessiva rispetto alle implementazioni tradizionali della tecnica RAG, che spesso prevedono moduli distinti per il recupero e la generazione.
+        
+Capacità di adattamento e apprendimento: I modelli di linguaggio generativi di grandi dimensioni sono noti per la loro capacità di adattarsi e imparare da nuovi dati e istruzioni.
+        
+Questo potrebbe consentire di raffinare e migliorare l'implementazione nel corso del tempo.
+        
+ Controllo e trasparenza: L'utilizzo di prompt espliciti per guidare il modello attraverso le diverse fasi del processo può migliorare la controllabilità e la trasparenza, consentendo di monitorare e regolare il comportamento del modello in modo più diretto.
+        
+Efficienza computazionale: Avere un'unica architettura integrata potrebbe comportare vantaggi in termini di efficienza computazionale rispetto a soluzioni che prevedono moduli separati.
+        
+Punti a sfavore (Contro):
+        
+Affidabilità e coerenza: Poiché un unico modello gestisce tutte le fasi, eventuali errori o incoerenze potrebbero propagarsi e amplificarsi attraverso l'intero processo, influenzando la qualità della risposta finale.
+        
+Bias dei dati di addestramento: Come per qualsiasi modello di linguaggio generativo, l’approccio potrebbe essere influenzato dai bias presenti nei dati di addestramento utilizzati, con potenziali impatti sulla correttezza e l'equità delle risposte generate.
+        
+Mancanza di specializzazione: Mentre i modelli di grandi dimensioni sono versatili, potrebbero non essere ottimizzati per compiti specifici come il recupero di informazioni o la generazione di risposte rispetto a moduli specializzati.
+        
+ Difficoltà di debug e interpretabilità: Con un'architettura integrata e basata su prompt, potrebbe essere più complesso eseguire il debug e comprendere le ragioni dietro a eventuali errori o comportamenti indesiderati del modello. 
+        
+In sintesi,la proposta presenta alcuni vantaggi interessanti in termini di semplificazione, adattabilità e controllo, ma solleva anche potenziali preoccupazioni riguardo all'affidabilità, ai bias, alla mancanza di specializzazione e alle difficoltà di debug e interpretabilità.
+Come per qualsiasi nuovo approccio, sarebbe necessario valutarlo attentamente attraverso sperimentazioni e test approfonditi per determinare l'efficacia e l'applicabilità in contesti specifici.       
+</pre>
+</div>

static/help2.html

@@ -0,0 +1,18 @@
+<div class="text">
+    <pre class="pre-text">
+Nella redazione della domanda bisogna tenere conto del fatto che la domanda viene poi inserita in un prompt nel quale si fa esplicita richiesta di utilizzare il documento fornito.
+Quindi è implicito il riferimento al/ai documenti archiviati.
+Tuttavia quando si tratta di documenti il cui contenuto è sicuramente disponibile in internet, può essere opportuno esplicitare nella domanda che ci si riferisce ai documenti forniti.
+</pre>
+    <p class="center"> Esempi di domande </p>
+    <div>
+        <p> Fai una relazione sul documento che ti ho fornito. </p>
+        <p> Approfondisci la tesi sostenuta nei documenti. </p>
+        <p> Confronta i diversi punti di vista espressi dagli autori. </p>
+        <p> Descrivi la personalità dei protagonisti. </p>
+        <p> Analizza il documento che ti ho fornito e illustrami eventuali contraddizioni. </p>
+        <p> Illustra i momenti salienti del racconto. </p>
+        <p> Analizzando il documento che ti ho fornito confronta le tesi di .. con quelle di .. </p>
+        <p> Quale è l'avvenimento più importante </p>
+    </div>
+</div>

static/javascript/rag_cleaner.js

@@ -0,0 +1,99 @@
+/** @format */
+
+function cleanDoc(txt) {
+  // Rimuove caratteri di controllo
+  function removeControlCharacters(str) {
+    return str.replace(/[\x00-\x1F\x7F-\x9F\u200B-\u200D\uFEFF]/g, "");
+  }
+  // Applica la rimozione dei caratteri di controllo
+  txt = txt.split("\n").map(removeControlCharacters).join("\n");
+  // Converte tabulazioni in spazi
+  txt = txt.replace(/\t/g, " ");
+  // Rimuove spazi multipli
+  txt = txt.replace(/ +/g, " ");
+  // Rimuove spazi all'inizio e alla fine di ogni riga
+  txt = txt
+    .split("\n")
+    .map((line) => line.trim())
+    .join("\n");
+  // Riduce linee vuote multiple a una sola
+  txt = txt.replace(/\n\s*\n/g, "\n\n");
+  // Uniforma i caratteri di quotazione
+  txt = txt.replace(/["""]/g, '"').replace(/['']/g, "'");
+  // Uniforma i trattini
+  txt = txt.replace(/[–—]/g, "-");
+  // Rimuove caratteri di escape visibili
+  txt = txt.replace(/\\[nrt]/g, "");
+  // Preserva caratteri Unicode (lettere e numeri), punteggiatura comune e spazi
+  txt = txt.replace(/[^\p{L}\p{N}\s\.,;:!?'"()\-]/gu, "");
+  // Rimuove spazi prima della punteggiatura
+  txt = txt.replace(/ +([.,;:!?])/g, "$1");
+  // Trim finale
+  return txt.trim();
+}
+
+// function removeLabel(text) {
+//   const ptr = /#+\s*(\w+)\s*(:\s*)?/; //solo la prima
+//   return text.replace(ptr, "");
+// }
+
+// function removeLabels(text) {
+//   const ptr = /#+\s*(\w+)\s*(:\s*)?/g; // globale
+//   return text.replace(ptr, "");
+// }
+
+function list2text(lst) {
+  const frasi = lst.map((sentence) => `${sentence.trim()}`);
+  text = frasi.join("\n");
+  return text;
+}
+
+// XXX
+// function cleanResponse(text) {
+//   // Dividi il testo in righe
+//   let rows = text.split("\n");
+//   // Rimuove numeri all'inizio delle righe
+//   let cleanedRows = rows.map((row) => row.replace(/^\d+\.\s*/, ""));
+//   // Unisce le righe in un singolo testo, separandole con ".\n"
+//   text = cleanedRows.join(".\n");
+//   // Rimuove punti multipli
+//   text = text.replace(/\.{2,}/g, ".");
+//   return text;
+// }
+
+//XXX
+// function cleanContext(text) {
+//   return text
+//     // Rimuove le linee di separazione composte da caratteri ripetuti
+//     .replace(/^[=\-_.]+$/gm, '')
+//     // Rimuove i simboli di elenco puntato (* - +) all'inizio delle righe
+//     .replace(/^[*\-+]\s*/gm, '')
+//     // Rimuove le righe vuote multiple, lasciando solo una riga vuota tra i paragrafi
+//     .replace(/\n\s*\n/g, '\n\n')
+//     // Rimuove gli spazi bianchi all'inizio e alla fine del testo
+//     .trim();
+// }
+
+
+function cleanOutput(text) {
+  // Rimuove gli spazi bianchi iniziali e finali
+  text = text.trim();
+  // Sostituisce le sequenze di più di due newline con due newline
+  text = text.replace(/\n{3,}/g, '\n\n');
+  // text = text.replace(/\n{2,}/g, '\n');
+  // Rimuove gli spazi bianchi extra all'inizio di ogni riga
+  text = text.replace(/^[ \t]+/gm, '');
+  // Sostituisce i trattini bassi multipli con una linea orizzontale
+  // text = text.replace(/_{3,}/g, '\n\n' + '-'.repeat(40) + '\n\n');
+  // Formatta gli elenchi puntati per una migliore leggibilità
+  text = text.replace(/^(\s*[-*•])(\s*)/gm, '\n$1 ');
+  // Formatta gli elenchi numerati per una migliore leggibilità
+  text = text.replace(/^(\s*\d+\.)(\s*)/gm, '\n$1 ');
+  // Aggiunge una riga vuota prima e dopo i blocchi di codice
+  text = text.replace(/(```[\s\S]*?```)/g, '\n\n$1\n\n');
+  // Aggiunge un'andata a capo dopo ogni punto, eccetto quando seguito da newline o fine stringa
+  // text = text.replace(/\.(?!\n|$)/g, '.\n'); 
+  // Rimuove gli spazi bianchi extra alla fine di ogni riga
+  text = text.replace(/[ \t]+$/gm, '');
+  return text;
+}

static/javascript/rag_data_mgr.js

@@ -0,0 +1,109 @@
+/** @format */
+
+"use strict";
+const UaDb = {
+  create(id, data) {
+    if (localStorage.getItem(id)) {
+      xerror(`ID ${id} already exists.`);
+      return;
+    }
+    localStorage.setItem(id, data);
+  },
+  read(id) {
+    const data = localStorage.getItem(id);
+    if (data === null) {
+      xlog(`UaDb.read  ${id} not found.`);
+      return "";
+    }
+    return data;
+  },
+  update(id, data) {
+    if (!localStorage.getItem(id)) {
+      xlog(`UaDb.update ${id} not found.`);
+      return;
+    }
+    localStorage.setItem(id, data);
+  },
+  delete(id) {
+    if (!localStorage.getItem(id)) {
+      xerror(`ID ${id} not found.`);
+      return;
+    }
+    localStorage.removeItem(id);
+  },
+  save(id, data) {
+    localStorage.setItem(id, data);
+  },
+  getAllIds() {
+    const ids = [];
+    for (let i = 0; i < localStorage.length; i++) {
+      ids.push(localStorage.key(i));
+    }
+    return ids;
+  },
+  saveArray(id, arr) {
+    const str = arr.join("|");
+    UaDb.save(id, str);
+  },
+  readArray(id) {
+    const str = UaDb.read(id);
+    if (str.trim().length == 0) return [];
+    const arr = str.split("|").map((item) => item.trim());
+    return arr;
+  },
+  saveJson(id, js) {
+    const str = JSON.stringify(js);
+    UaDb.save(id, str);
+  },
+  readJson(id) {
+    const str = UaDb.read(id);
+    if (!str) return {};
+    const js = JSON.parse(str);
+    return js;
+  },
+};
+
+const DataMgr = {
+  docs: [],
+  doc_names: [],
+  linkToName(link) {
+    const parts = link.split("/");
+    return parts[parts.length - 1];
+  },
+  async loadDoc(link) {
+    try {
+      const text = await requestGet(link);
+      const doc = cleanDoc(text);
+      const name = this.linkToName(link);
+      this.doc_names.push(name);
+      this.docs.push(doc);
+      this.saveDbDocs();
+      return doc;
+    } catch (err) {
+      alert("loadDoc()\n" + err + "\n" + link);
+    }
+  },
+  addDoc(name, text) {
+    const doc = cleanDoc(text);
+    this.docs.push(doc);
+    this.doc_names.push(name);
+    this.saveDbDocs();
+  },
+  saveDbDocs() {
+    UaDb.saveArray("id_doc_names", this.doc_names);
+    UaDb.saveArray("id_docs", this.docs);
+  },
+  readDbDocs() {
+    this.docs = UaDb.readArray("id_docs");
+  },
+  readDbDocNames() {
+    this.doc_names = UaDb.readArray("id_doc_names");
+  },
+  deleteDati() {
+    const ids = UaDb.getAllIds();
+    for (const id of ids) {
+      if (["id_docs", "id_doc_names"].includes(id)) continue;
+      UaDb.delete(id);
+    }
+  },
+};

static/javascript/rag_http.js

@@ -0,0 +1,220 @@
+/** @format */
+"use strict";
+
+const model_name = "mistralai/Mistral-7B-Instruct-v0.3";
+// const model_name = "mistralai/Mixtral-8x7B-Instruct-v0.1";
+// const model_name = "mistralai/Mixtral-8x22B-Instruct-v0.1"
+// const model_name = "google/gemma-2-9b-it"
+
+function decodeTokenBase64(encodedToken) {
+  return atob(encodedToken);
+}
+
+const encodedToken = "aGZfT0VBQVpoUmJtdEFLRENOVGZTcFZwVHdhbGpielBvQnlhbA"; // Questo è "your_token_here" codificato
+const HF_TOKEN = decodeTokenBase64(encodedToken);
+
+async function requestGet(url) {
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Content-Type": "text/plain;charset=UTF-8",
+      },
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP error! status: ${response.status}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    const text = new TextDecoder("utf-8").decode(arrayBuffer);
+    return text;
+  } catch (error) {
+    console.error(error);
+    let message;
+    if (error.name === "AbortError") {
+      message = "Request was aborted";
+    } else if (error.message.includes("HTTP error! status")) {
+      message = error.message;
+    } else {
+      message = "An error occurred";
+    }
+    alert(`requestGet()\nurl: ${url}\n${message}`);
+    throw error;
+  }
+}
+const ERROR_TOKENS = "ERROR_TOKENS";
+const TIMEOUT_ERROR = "TIMEOUT_ERROR";
+
+const HfRequest = {
+  controller: null,
+  isCancelled: false,
+  baseUrl: "https://api-inference.huggingface.co/models",
+
+  async post(payload, timeout = 30000) {
+    this.isCancelled = false;
+    this.controller = new AbortController();
+
+    try {
+      const timeoutId = setTimeout(() => {
+        this.controller.abort();
+      }, timeout);
+      const response = await fetch(`${this.baseUrl}/${model_name}`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${HF_TOKEN}`,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(payload),
+        signal: this.controller.signal,
+      });
+      clearTimeout(timeoutId);
+      if (this.isCancelled) return null;
+      const data = await response.json();
+      if (!response.ok) {
+        const errorType = this.checkError(response.status, data);
+        const errorInfo = this.createErrorInfo(response.status, response.statusText, data.error, errorType);
+        throw new Error(errorInfo);
+      }
+      const errorType = this.isInvalidResponse(data);
+      if (typeof errorType === "string") {
+        const errorInfo = this.createErrorInfo(response.status, response.statusText, data.error, errorType);
+        throw new Error(errorInfo);
+      }
+      return data[0].generated_text.trim();
+    } catch (error) {
+      if (this.isCancelled) return null;
+      if (error.name === "AbortError") {
+        const errorInfo = this.createErrorInfo(0, "Timeout", "La richiesta è scaduta", TIMEOUT_ERROR);
+        throw new Error(errorInfo);
+      }
+      throw error;
+    }
+  },
+
+  cancelRequest() {
+    if (this.controller) {
+      this.isCancelled = true;
+      this.controller.abort();
+    }
+  },
+
+  checkError(status, data) {
+    let errorType;
+    if (status >= 500) {
+      errorType = "SERVER_ERROR";
+    } else if (status >= 400 && status < 500) {
+      if (typeof data === "object" && data.error_type === "validation") {
+        if (data.error.includes("tokens")) {
+          errorType = ERROR_TOKENS;
+        } else {
+          errorType = "ERROR_VALIDATION";
+        }
+      } else {
+        errorType = "CLIENT_ERROR";
+      }
+    } else {
+      errorType = "UNKNOWN_ERROR";
+    }
+    return errorType;
+  },
+
+  isInvalidResponse(data) {
+    if (!data || !Array.isArray(data) || data.length === 0) {
+      return "INVALID_DATA";
+    }
+    if (!data[0].generated_text) {
+      return "MISSING_GENERATED_TEXT";
+    }
+    return null;
+  },
+
+  createErrorInfo(status, statusText, msg, errorType) {
+    const err = {
+      status: status,
+      statusText: statusText,
+      errorType: errorType,
+      message: msg || "Errore sconosciuto",
+    };
+    return JSON.stringify(err);
+  },
+};
+/////////////////////////
+
+// const HfError = class extends Error {
+//   constructor(status, statusText, message, errorType) {
+//     super(message);
+//     this.name = "HfError";
+//     this.status = status;
+//     this.statusText = statusText;
+//     this.errorType = errorType;
+//   }
+// };
+
+// const HfRequest = {
+//   controller: null,
+//   isCancelled: false,
+//   baseUrl: "https://api-inference.huggingface.co/models",
+
+//   async post(payload, timeout = 30000) {
+//     this.isCancelled = false;
+//     this.controller = new AbortController();
+
+//     try {
+//       const timeoutId = setTimeout(() => this.controller.abort(), timeout);
+//       const response = await fetch(`${this.baseUrl}/${model_name}`, {
+//         method: "POST",
+//         headers: {
+//           Authorization: `Bearer ${HF_TOKEN}`,
+//           "Content-Type": "application/json",
+//         },
+//         body: JSON.stringify(payload),
+//         signal: this.controller.signal,
+//       });
+//       clearTimeout(timeoutId);
+//       if (this.isCancelled) return null;
+//       const data = await response.json();
+//       if (!response.ok) {
+//         throw this.createError(response, data);
+//       }
+//       if (!Array.isArray(data) || data.length === 0 || !data[0].generated_text) {
+//         throw this.createError(response, data, "Risposta non valida", "INVALID_RESPONSE");
+//       }
+//       return data[0].generated_text.trim();
+//     } catch (error) {
+//       if (this.isCancelled) return null;
+//       if (error.name === "AbortError") {
+//         throw this.createError(null, null, "La richiesta è scaduta", "TIMEOUT_ERROR");
+//       }
+//       if (error instanceof HfError) throw error;
+//       throw this.createError(null, null, error.message, "UNKNOWN_ERROR");
+//     }
+//   },
+
+//   cancelRequest() {
+//     if (this.controller) {
+//       this.isCancelled = true;
+//       this.controller.abort();
+//     }
+//   },
+
+//   createError(response, data, customMessage, customErrorType) {
+//     const status = response ? response.status : 0;
+//     const statusText = response ? response.statusText : "Unknown Error";
+//     const message = customMessage || (data && data.error) || "Errore sconosciuto";
+//     let errorType = customErrorType;
+
+//     if (!errorType) {
+//       if (status >= 500) errorType = "SERVER_ERROR";
+//       else if (status >= 400 && status < 500) {
+//         if (data && data.error_type === "validation") {
+//           errorType = data.error.includes("tokens") ? "ERROR_TOKENS" : "ERROR_VALIDATION";
+//         } else {
+//           errorType = "CLIENT_ERROR";
+//         }
+//       } else {
+//         errorType = "UNKNOWN_ERROR";
+//       }
+//     }
+
+//     return new HfError(status, statusText, message, errorType);
+//   },
+// };

static/javascript/rag_mgr.js

@@ -0,0 +1,405 @@
+/** @format */
+/**
+ * @license
+ * rag_rqs
+ * Copyright (C) 2024 [Il tuo nome]
+ *
+ * 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/>.
+ */
+"use strict";
+const MAX_PROMPT_LENGTH = 1024 * 88;
+// decremento dopo errore per tokens eccessivi
+const PROMPT_DECR = 1024 * 2;
+
+const Rag = {
+  // costituito dalla risposte accumulate sistemate
+  ragContext: "",
+  //query usata per creare la lista delle rispste
+  ragQuery: "",
+  // risposta finale alla qury contetso
+  ragResponse: "",
+  responses: [],
+  prompts: [],
+  doc: "",
+  doc_part: "",
+  saveToDb() {
+    const js = {
+      context: this.ragContext,
+      ragquery: this.ragQuery,
+      ragresponse: this.ragResponse,
+    };
+    UaDb.saveJson("id_rag", js);
+  },
+  readFromDb() {
+    const js = UaDb.readJson("id_rag");
+    this.ragContext = js.context || "";
+    this.ragQuery = js.ragquery || "";
+    this.ragResponse = js.ragresponse || "";
+  },
+  saveRespToDb() {
+    UaDb.saveArray("id_responses", this.responses);
+  },
+  readRespsFromDb() {
+    this.responses = UaDb.readArray("id_responses");
+  },
+  addPrompt(p) {
+    this.prompts.push(p);
+  },
+  responsesLength() {
+    const rspsl = this.responses.reduce((acc, cur) => {
+      return acc + cur.length;
+    }, 0);
+    return rspsl;
+  },
+  log(msg, plft, prgt) {
+    const maxl = MAX_PROMPT_LENGTH;
+    const rspsl = this.responsesLength();
+    const d = "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;";
+    let s = `${msg} mx:${maxl} lft:${plft} rgt:${prgt} arr:${rspsl}`;
+    xlog(s);
+    s = `${msg}${d}${plft}${d}${prgt}${d}${rspsl}`;
+    //nsg plft.length prgt.length responses.length
+    UaLog.log(s);
+  },
+  truncInput(txt, decr) {
+    const tl = txt.length;
+    const lim = tl - decr;
+    const s = txt.substring(0, lim);
+    return s;
+  },
+  getPartSize(doc, prompt, decr) {
+    const limitWIthPoint = (s, free_len) => {
+      const idx = s.indexOf(".", free_len);
+      let lim = (idx != -1 ? idx : free_len) + 1;
+      if (lim > free_len + 100) {
+        lim = free_len;
+      }
+      return lim;
+    };
+
+    const dpl = doc.length + prompt.length;
+    const free_len = MAX_PROMPT_LENGTH - decr;
+    let size = 0;
+    if (dpl < free_len) {
+      size = doc.length;
+    } else {
+      size = limitWIthPoint(doc, free_len);
+    }
+    return size;
+  },
+  getPartDoc(doc, partSize) {
+    const part = doc.substring(0, partSize);
+    doc = doc.substring(partSize).trim();
+    return [part, doc];
+  },
+
+  errorInfo(err) {
+    const js = JSON.parse(err.message);
+    return js;
+  },
+  errorTotext(e) {
+    //
+    const j = JSON.parse(e.message);
+    return `Errore:
+    Stato: ${j.status}
+    Descrizione stato: ${j.statusText}
+    Tipo di errore: ${j.errorType}
+    Messaggio: ${j.message}`;
+  },
+
+  // documenti => risposte RAG => context
+  async requestDocsRAG(query) {
+    ThreadMgr.init();
+    DataMgr.deleteDati();
+    DataMgr.readDbDocNames();
+    DataMgr.readDbDocs();
+    this.ragQuery = query;
+    this.ragContext = "";
+    this.ragResponse = "";
+    this.responses = [];
+    this.prompts = [];
+    let ndoc = 0;
+
+    try {
+      for (let i = 0; i < DataMgr.docs.length; i++) {
+        let doc = DataMgr.docs[i];
+        if (doc.trim() == "") continue;
+        const name = DataMgr.doc_names[i];
+        const doc_entire_len = doc.length;
+        UaLog.log(`${name} (${doc_entire_len}) `);
+        xlog(`${name} (${doc_entire_len}) `);
+        ++ndoc;
+        let npart = 0;
+        let partLft = "";
+        let partRgt = "";
+        let decr = 0;
+        let prompt = "";
+        // etsrazione informazioi da documenti
+        while (true) {
+          let partSize = this.getPartSize(doc, promptDoc("", query), decr);
+          if (partSize < 10) break;
+          // xlog("====================");
+          // xlog("partLft.lemngth:", partLft.length);
+          // xlog("partRgt.lemngth:", partRgt.length);
+          // xlog("prompt.length;", prompt.length);
+          [partLft, partRgt] = this.getPartDoc(doc, partSize);
+          prompt = promptDoc(partLft, query);
+          // xlog("------------");
+          // xlog("decr:", decr);
+          // xlog("partSize:", partSize);
+          // xlog("partLft.lemngth:", partLft.length);
+          // xlog("partRgt.lemngth:", partRgt.length);
+          // xlog("prompt.length;", prompt.length);
+          const payload = getPayloadDoc(prompt);
+          let text;
+          try {
+            text = await HfRequest.post(payload);
+            if (!text) return "";
+          } catch (err) {
+            const e = this.errorInfo(err);
+            if (e.errorType === ERROR_TOKENS) {
+              UaLog.log(`Error tokens.1  ${prompt.length}`);
+              xlog(`Error tokens.  ${prompt.length}`);
+              decr += PROMPT_DECR;
+              continue;
+            } else {
+              xerror(err);
+              const s = this.errorTotext(err);
+              throw s;
+            }
+          }
+          npart++;
+          doc = partRgt;
+          if (npart == 1) {
+            text = `[[NOME_DOCUMENTO]]:${name}\n${text}`;
+          }
+          this.responses.push(text);
+          this.log(`${ndoc},${npart}`, partLft.length, partRgt.length);
+        }
+      }
+    } catch (error) {
+      alert("requestDocsRAG(1)\n" + error);
+      xerror(error);
+    }
+
+    // elenco risposte accumulate => contesto
+    /*
+    try {
+      let resps = list2text(this.responses);
+      let decr = 0;
+      let text = "";
+      let prompt = "";
+
+      while (true) {
+        resps = this.truncInput(resps, decr);
+        prompt = promptToContext(resps, query);
+        const payload = getPlayloadContext(prompt);
+
+        try {
+          text = await HfRequest.post(payload);
+          if (!text) return "";
+        } catch (err) {
+          const e = this.errorInfo(err);
+          if (e.errorType === ERROR_TOKENS) {
+            UaLog.log(`Error tokens.2  ${prompt.length}`);
+            xlog(`Error tokens.  ${prompt.length}`);
+            decr += PROMPT_DECR;
+            continue;
+          } else {
+            xerror(err);
+            const s = this.errorTotext(err);
+            throw s;
+          }
+        }
+        break;
+      }
+      const pl = prompt.length;
+      //XXX text = cleanContext(text); 
+      this.ragContext = text;
+      this.saveToDb();
+      UaLog.log(`Contesto  (${pl})`);
+    } catch (error) {
+      xerror(error);
+      alert("requestDocsRAG(2)\n" + error);
+      throw error;
+    }
+      */
+    ////////////////////////////
+    // ALTENATIVA elenco come coontext
+    const resps = list2text(this.responses);
+    this.ragContext = resps;
+    this.saveToDb();
+    ////////////////////////////
+
+    // query finale utilizza context
+    {
+      let text = "";
+      try {
+        let prompt = promptWithContext(this.ragContext, query);
+        const payload = getPayloadQuery(prompt);
+
+        try {
+          text = await HfRequest.post(payload);
+          if (!text) return "";
+        } catch (err) {
+          const e = this.errorInfo(err);
+          const s = this.errorTotext(err);
+          if (e.errorType === ERROR_TOKENS) {
+            xerror(err);
+            throw s;
+          } else {
+            xerror(err);
+            throw s;
+          }
+        }
+        this.ragResponse = text; 
+        this.saveRespToDb();
+        this.saveToDb();
+        const pl = prompt.length;
+        UaLog.log(`Risposta  (${pl},${text.length})`);
+      } catch (error) {
+        text = error;
+        xerror(error);
+        alert("requestDocsRAG(3)\n" + error);
+        throw error;
+      } finally {
+        text = cleanOutput(text); 
+        return text;
+      }
+    }
+  },
+
+  // TRHREAD
+  async requestContext(query) {
+    this.readFromDb();
+
+    if (!this.ragContext) {
+      const ok = await confirm("Contesto vuoto. Vuoi continuare?");
+      if (!ok) return "";
+    }
+
+    if (ThreadMgr.isFirst()) {
+      let outText = "";
+      try {
+        let context = this.ragContext;
+        let prompt = promptWithContext(context, query);
+        const payload = getPayloadQuery(prompt);
+
+        let text;
+        try {
+          text = await HfRequest.post(payload);
+          if (!text) return "";
+        } catch (err) {
+          const e = this.errorInfo(err);
+          if (e.errorType === ERROR_TOKENS) {
+            UaLog.log(`Error tokens.4  ${prompt.length}`);
+            xerror(err);
+            throw err;
+          } else {
+            alert(err)
+            xerror(err);
+            throw err;
+          }
+        }
+        ThreadMgr.add(query, text);
+        outText = ThreadMgr.getOutText();
+        UaLog.log(`Inizio Conversazione (${prompt.length},${text.length})`);
+      } catch (error) {
+        xerror(error);
+        outText = error;
+        throw error;
+      } finally {
+        outText = cleanOutput(outText); 
+        return outText;
+      }
+    } else {
+      let outText = "";
+      try {
+        let context = this.ragContext;
+        let thread = ThreadMgr.getThread();
+        let prompt = "";
+        let text = "";
+        let decr = 0;
+
+        while (true) {
+          thread = this.truncInput(thread, decr);
+          prompt = promptThread(context, thread, query);
+          const payload = getPayloadQuery(prompt);
+
+          try {
+            text = await HfRequest.post(payload);
+            if (!text) return "";
+          } catch (err) {
+            const e = this.errorInfo(err);
+            if (e.errorType === ERROR_TOKENS) {
+              UaLog.log(`Error tokens.5  ${prompt.length}`);
+              xlog(`Error tokens.  ${prompt.length}`);
+              decr += PROMPT_DECR;
+              continue;
+            } else {
+              xerror(err);
+              throw e.errorType;
+            }
+          }
+          break;
+        }
+        ThreadMgr.add(query, text);
+        outText = ThreadMgr.getOutText();
+        UaLog.log(`Conversazione  (${prompt.length},${text.length})`);
+      } catch (error) {
+        alert("requestContext(2) \n" + error);
+        xerror(error);
+        outText = error;
+        throw error;
+      } finally {
+        outText = cleanOutput(outText); 
+        return outText;
+      }
+    }
+  },
+};
+
+const ThreadMgr = {
+  rows: [],
+  init() {
+    this.rows = [];
+  },
+  add(query, resp) {
+    const row = [query, resp];
+    this.rows.push(row);
+  },
+  getOutText() {
+    const rows = [];
+    for (const ua of this.rows) {
+      const u = ua[0].trim();
+      const a = ua[1].trim();
+      rows.push(`<user>:\n${u}\n<Assistant>:\n${a}\n\n`);
+    }
+    let text = rows.join("").trim();
+    return text;
+  },
+  getThread() {
+    const rows = [];
+    for (const ua of this.rows) {
+      const u = ua[0].trim();
+      const a = ua[1].trim();
+      rows.push(`<user>:\n${u}\n<Assitant>:\n${a}\n\n`);
+    }
+    const text = rows.join("").trim();
+    return text;
+  },
+  isFirst() {
+    return this.rows.length == 0;
+  },
+};

static/javascript/rag_prompts.js

@@ -0,0 +1,235 @@
+"use strict";
+
+function promptDoc(documento, domanda) {
+  return `
+[[RUOLO]]
+Analista di documenti esperto nell'estrazione di informazioni pertinenti.
+
+[[COMPITO]]
+Analizza il documento e estrai le informazioni rilevanti per la domanda.
+
+[[DOCUMENTO]]
+${documento}
+
+[[DOMANDA]]
+${domanda}
+
+[[ISTRUZIONI]]
+1. Identifica i concetti chiave e sintetizzali per fornire una risposta completa.
+2. Assicurati di organizzare le informazioni in modo chiaro e logico.
+3. Conserva le informazioni contrastanti, se presenti, senza tentare di risolverle.
+4. Puoi fare inferenze ragionevoli basate sulle informazioni fornite.
+5. Includi citazioni o riferimenti specifici al documento solo se necessari per chiarire la descrizione.
+
+[[OUTPUT]]
+Elenco delle informazioni identificate, incluse eventuali inferenze
+`;
+}
+
+function promptToContext(risposte) {
+  return `
+[[RUOLO]]
+Esperto di analisi semantica delle informazioni.
+
+[[OBIETTIVO]]
+Unificare le informazioni semanticamente equivalenti da vari documenti.
+
+[[ELENCO_RISPOSTE]]
+${risposte}
+
+[[ISTRUZIONI]]
+1. Analizza le informazioni dell'elenco risposte.
+2. Per ogni documento raggruppa le informazioni sulla base del loro significato.
+3. Presenta le informazioni in modo chiaro e coerente.
+
+[[OUTPUT]]
+Elenco delle informazioni mantenendo la divisione per documento.
+`;
+}
+
+function promptWithContext(contesto, domanda) {
+  return `
+[[COMPITO]]
+Elabora una risposta esaustiva e pertinente alla domanda basata sul contesto fornito.
+
+[[CONTESTO]]
+${contesto}
+
+[[DOMANDA]]
+${domanda}
+
+[[ISTRUZIONI]]
+1. Analizza attentamente il contesto e la domanda posta.
+2. Struttura una risposta logica, coerente e completa.
+3. Utilizza le informazioni del contesto, citando i documenti di origine solo se necessario per chiarire la descrizione.
+4. Evidenzia le connessioni tra i vari concetti e le fonti.
+5. Includi inferenze ragionevoli.
+
+[[OUTPUT]]
+L'output è destinato ad essere letto da un lettore italiano.
+`;
+}
+
+function promptThread(contesto, conversazione, domanda) {
+  return `
+[[COMPITO]]
+Rispondi alla nuova domanda integrando il contesto iniziale e gli sviluppi della conversazione in corso.
+
+[[CONTESTO]]
+${contesto}
+
+[[CONVERSAZIONE]]
+${conversazione}
+
+[[DOMANDA]]
+${domanda}
+
+[[ISTRUZIONI]]
+1. Analizza la nuova domanda nel contesto della conversazione in corso.
+2. Integra le informazioni dal contesto iniziale con gli sviluppi della discussione.
+3. Mantieni la coerenza con la conversazione precedente, evitando ripetizioni non necessarie.
+4. Puoi fare inferenze ragionevoli.
+5. Adatta la risposta alla domanda attuale, anche se si discosta dal tema principale della conversazione.
+6. Usa citazioni o riferimenti solo se necessario per chiarire la descrizione.
+
+[[OUTPUT]]
+L'output è destinato ad essere letto da un lettore italiano.
+`;
+}
+
+///////////////////////////////////}
+/*
+
+1. max_new_tokens: 512
+   Questo è un valore ragionevole per risposte di lunghezza media. 
+   Potrebbe essere aumentato a 1024 o più se si desiderano risposte più lunghe e dettagliate.
+
+2. temperature: 0.7
+   Questo valore offre un buon equilibrio tra creatività e coerenza. 
+   Va bene per la maggior parte degli usi.
+
+3. top_k: 50
+   Un valore standard che limita la selezione alle 50 parole più probabili.
+   È appropriato per la maggior parte delle applicazioni.
+
+4. top_p: 0.85
+   Questo valore di nucleus sampling è buono per mantenere un buon equilibrio
+    tra diversità e coerenza.
+
+5. do_sample: true
+   Corretto per generare testo più vario.
+
+6. no_repeat_ngram_size: 3
+   Aiuta a evitare ripetizioni a breve termine. 
+   Potrebbe essere aumentato a 4 o 5 per evitare ripetizioni più lunghe.
+
+7. num_beams: 5
+   Un buon valore per la beam search.
+    Aumentarlo potrebbe migliorare la qualità ma aumenterebbe anche il 
+    tempo di elaborazione.
+
+8. repetition_penalty: 1.2
+   Un valore moderato per penalizzare le ripetizioni.
+    Potrebbe essere aumentato leggermente (es. 1.3 o 1.4) se si notano 
+    ancora troppe ripetizioni.
+
+9. return_full_text: false
+   Corretto se si vuole solo il nuovo testo generato.
+
+10. max_time: 60.0
+    Un minuto è un tempo ragionevole. Potrebbe essere aumentato 
+    se si stanno generando risposte molto lunghe o complesse.
+
+11. seed: 42
+    Un valore fisso per la riproducibilità. 
+    Va bene se si desidera coerenza tra le esecuzioni.
+
+Suggerimenti per l'ottimizzazione:
+1. Considera di aumentare max_new_tokens a 1024 o più se hai bisogno di risposte più lunghe.
+2. Potresti aumentare leggermente no_repeat_ngram_size a 4 per ridurre ulteriormente le ripetizioni.
+3. Se desideri risposte più precise e meno creative, potresti ridurre temperature a 0.6 e top_p a 0.8.
+4. Per risposte più diverse, potresti aumentare temperature a 0.8 e top_p a 0.9.
+5. Se noti ancora troppe ripetizioni, considera di aumentare repetition_penalty a 1.3 o 1.4.
+*/
+const getPayloadDoc = (prompt) => {
+  let payload = {
+    inputs: prompt,
+    parameters: {
+      task: "text2text-generation",
+      max_new_tokens: 512,
+      num_return_sequences: 1,
+      temperature: 0.6,
+      top_k: 50,
+      top_p: 0.85,
+      do_sample: true,
+      no_repeat_ngram_size: 4,
+      num_beams: 6,
+      repetition_penalty: 1.2,
+      return_full_text: false,
+      details: false,
+      max_time: 90.0,
+      seed: 42,
+    },
+    options: {
+      use_cache: false,
+      wait_for_model: true,
+    },
+  };
+  return payload;
+};
+
+const getPlayloadContext = (prompt) => {
+  let payload = {
+    inputs: prompt,
+    parameters: {
+      task: "text2text-generation",
+      max_new_tokens: 1024,
+      num_return_sequences: 1,
+      temperature: 0.8,
+      top_k: 50,
+      top_p: 0.85,
+      do_sample: true,
+      no_repeat_ngram_size: 3,
+      num_beams: 5,
+      repetition_penalty: 1.1,
+      return_full_text: false,
+      details: false,
+      max_time: 120.0,
+      seed: 42,
+    },
+    options: {
+      use_cache: false,
+      wait_for_model: true,
+    },
+  };
+  return payload;
+};
+
+const getPayloadQuery = (prompt) => {
+  const seed = Math.floor(Math.random() * Math.pow(2, 32));
+  let payload = {
+    inputs: prompt,
+    parameters: {
+      task: "text-generation",
+      max_new_tokens: 512,
+      num_return_sequences: 1,
+      temperature: 0.7,
+      top_k: 50,
+      top_p: 0.85,
+      do_sample: true,
+      no_repeat_ngram_size: 3,
+      num_beams: 5,
+      repetition_penalty: 1.4,
+      return_full_text: false,
+      details: false,
+      max_time: 120.0,
+      seed: 42,
+    },
+    options: {
+      use_cache: false,
+      wait_for_model: true,
+    },
+  };
+  return payload;
+};
+

static/javascript/rag_rqs.js

@@ -0,0 +1,243 @@
+/** @format */
+/**
+ * @license
+ * rag_rqs
+ * Copyright (C) 2024 [Il tuo nome]
+ *
+ * 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/>.
+ */
+
+"use strict";
+const VERS = "0.1.33 (16-07-2024)";
+
+var xlog = console.log;
+var xerror = console.error;
+//////////////////////
+
+/////////////////////////
+// let T0 = {};
+
+// var start_performance = function (k) {
+//   T0.k = performance.now();
+// };
+
+// var log_performance = function (k, msg = "") {
+//   const t1 = performance.now();
+//   const d = t1 - T0.k;
+//   console.log(msg, d);
+//   T0.k = t1;
+//   return d;
+// };
+
+// function showMessage(message, duraction = 5000) {
+//   const popup = document.createElement("div");
+//   popup.className = "msg";
+//   popup.innerText = message;
+//   document.body.appendChild(popup);
+//   setTimeout(function () {
+//     document.body.removeChild(popup);
+//   }, duraction);
+// }
+
+const cancelRequest = () => {
+  const ok = confirm("Confermi Cancellazione Richeista ?");
+  if (!ok) return;
+  HfRequest.cancelRequest();
+  hideSpinner();
+};
+
+const showSpinner = () => {
+  const spinner = document.getElementById("spinner");
+  spinner.classList.add("show-spinner");
+  spinner.addEventListener("click", cancelRequest);
+};
+
+const hideSpinner = () => {
+  const spinner = document.getElementById("spinner");
+  spinner.classList.remove("show-spinner");
+  spinner.removeEventListener("click", cancelRequest);
+};
+
+////////////////////////
+function openApp() {
+  wnds.init();
+  Menu.init();
+  TextInput.init();
+  TextOutput.init();
+  document.querySelector(".menu-btn").checked = false;
+  release();
+}
+
+function release() {
+  document.querySelector(".release").innerHTML = VERS;
+}
+
+/////////////////////////
+// README
+const op0 = async function (e) {
+  const text = await requestGet("./help1.html");
+  wnds.wdiv.show(text);
+};
+
+//query iniziale
+function op1(e) {
+  Rag.readFromDb();
+  const txt = `\n${Rag.ragQuery}`;
+  wnds.wpre.show(txt);
+  // Menu.close();
+}
+
+//Rispost Rsg
+function showRagResponse(e) {
+  Rag.readFromDb();
+  const txt = `\n${Rag.ragResponse}`;
+  wnds.wpre.show(txt);
+}
+
+//elenco risposte
+function op2(e) {
+  let rs = [...Rag.responses];
+  if (rs.length == 0) {
+    rs = UaDb.readArray("id_responses");
+  }
+  if (rs.length == 0) return;
+  const text = rs
+    .map((x, i) => {
+      return `[${i + 1}]\n ${x.trim()}`;
+    })
+    .join("\n");
+  wnds.wpre.show(text);
+  // Menu.close();
+}
+
+//contesto
+function op3(e) {
+  Rag.readFromDb();
+  const txt = `${Rag.ragContext}`;
+  wnds.wpre.show(txt);
+  // Menu.close();
+}
+
+//elemco dati
+function op4(e) {
+  const ids = UaDb.getAllIds();
+  const arr = [];
+  for (const id of ids) {
+    const s = UaDb.read(id);
+    const l = s.length;
+    arr.push(`${id} (${l})`);
+  }
+  let msg = arr.join("\n ");
+  wnds.wpre.show(msg);
+}
+
+//elenco documenti
+async function op5(e) {
+  DataMgr.readDbDocNames();
+  const arr = DataMgr.doc_names;
+  const s = arr.join("\n");
+  wnds.wpre.show(s);
+}
+
+//calcolo query
+function calcQuery() {
+  const calc = () => {
+    const arr = [];
+    let nptot = 0;
+    let i = 0;
+    arr.push(`Documento   Num.Parti`);
+    arr.push("==================");
+    for (const doc of DataMgr.docs) {
+      const name = DataMgr.doc_names[i];
+      i += 1;
+      const dl = doc.length;
+      const np = Math.ceil(dl / MAX_PROMPT_LENGTH);
+      nptot += np;
+      arr.push(`${name}&nbsp;&nbsp;&nbsp;[${np}]`);
+    }
+    arr.push("==================");
+    arr.push(`Totale num. Parti: ${nptot}`);
+    const s = arr.join("\n");
+    return s;
+  };
+  DataMgr.readDbDocs();
+  DataMgr.readDbDocNames();
+  const s = calc();
+  wnds.wpre.show(s);
+}
+
+//cancellA DATI
+function op7(e) {
+  const ok = confirm("Confermi cancellazione dati?");
+  if (ok) {
+    DataMgr.deleteDati();
+    Rag.ragContext = "";
+    Rag.ragQuery = "";
+    Rag.responses = [];
+    wnds.wdiv.close();
+    wnds.wpre.close();
+    TextOutput.clear();
+  }
+}
+//cancella localstrage
+function op8(e) {
+  const ok = confirm("Confermi cancellazione documenti & dati?");
+  if (ok) {
+    localStorage.clear();
+    Rag.ragContext = "";
+    Rag.ragQuery = "";
+    Rag.responses = [];
+    wnds.wdiv.close();
+    wnds.wpre.close();
+    TextOutput.clear();
+    DataMgr.docs = [];
+    DataMgr.doc_names = [];
+  }
+}
+////////////////////////////////
+// Solo Sviluppo
+//prompts
+function op9(e) {
+  if (Rag.prompts.length == 0) return;
+  const text = Rag.prompts
+    .map((x, i) => {
+      return `[${i + 1}]${x}\n`;
+    })
+    .join("\n");
+  wnds.wpre.show(text);
+}
+//testi
+function op6(e) {
+  DataMgr.readDbDocs();
+  const arr = DataMgr.docs;
+  const s = arr.join("\n");
+  wnds.wpre.show(s);
+}
+///////////////////////////
+async function help1(e) {
+  const text = await requestGet("./data/help_test.html");
+  wnds.wdiv.show(text);
+}
+
+//lanciata dalla pagina diegli sempi
+function esempio(name) {
+  const link = `data/${name}`;
+  DataMgr.loadDoc(link);
+  wnds.wdiv.close();
+}
+
+async function help2(e) {
+  const text = await requestGet("./help2.html");
+  wnds.wdiv.show(text);
+}

static/javascript/rag_ui.js

@@ -0,0 +1,360 @@
+/** @format */
+/**
+ * @license
+ * rag_rqs
+ * Copyright (C) 2024 [Il tuo nome]
+ *
+ * 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/>.
+ */
+const WndPre = (id) => {
+  return {
+    w: UaWindowAdm.create(id),
+    out: null,
+    show(s) {
+      const fh = (txt) => {
+        return `
+<div class="window-text">
+<div class="btn-wrapper">
+<button class="btn-copy" title="Copia">
+<svg class="copy-icon" viewBox="0 0 20 24">
+  <path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
+</svg>
+</button>
+<button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>
+</div>
+<pre class="pre-text">${txt}</pre>
+</div>
+    `;
+      };
+      wnds.closeAll();
+      const h = fh(s);
+      this.w.drag();
+      this.w.setZ(12);
+      this.w.vw_vh().setXY(16.5, 10, -1);
+      this.w.setHtml(h);
+      this.w.show();
+      const e = this.w.getElement();
+      const copyBtn = e.querySelector(".btn-copy");
+      copyBtn.addEventListener("click", () => this.copy());
+    },
+    close() {
+      this.w.close();
+    },
+    async copy() {
+      const e = this.w.getElement();
+      const pre = e.querySelector(".pre-text");
+      const t = pre.textContent;
+      try {
+        await navigator.clipboard.writeText(t);
+      } catch (err) {
+        xerror("Errore  ", err);
+      }
+    },
+  };
+};
+
+const WndDiv = (id) => {
+  return {
+    w: UaWindowAdm.create(id),
+    out: null,
+    show(s) {
+      const fh = (txt) => {
+        return `
+<div class="window-text">
+<div class="btn-wrapper">
+<button class="btn-copy" title="Copia">
+<svg class="copy-icon" viewBox="0 0 20 24">
+<path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
+</svg>
+</button>
+<button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>
+</div>
+<div class="div-text">${txt}</div>
+</div>
+    `;
+      };
+      wnds.closeAll();
+      const h = fh(s);
+      this.w.drag();
+      this.w.setZ(12);
+      this.w.vw_vh().setXY(16.5, 10, -1);
+      this.w.setHtml(h);
+      this.w.show();
+      const e = this.w.getElement();
+      const copyBtn = e.querySelector(".btn-copy");
+      copyBtn.addEventListener("click", () => this.copy());
+    },
+    close() {
+      this.w.close();
+    },
+    async copy() {
+      const e = this.w.getElement();
+      const pre = e.querySelector(".div-text");
+      const t = pre.textContent;
+      try {
+        await navigator.clipboard.writeText(t);
+      } catch (err) {
+        xerror("Errore  ", err);
+      }
+    },
+  };
+};
+
+const wnds = {
+  wdiv: null,
+  wpre: null,
+  wout: null,
+  init() {
+    this.wdiv = WndDiv("id_w0");
+    this.wpre = WndPre("id_w1");
+    this.wout = WndPre("id_out");
+  },
+  closeAll() {
+    UaWindowAdm.close("id_w0");
+    UaWindowAdm.close("id_w1");
+    UaWindowAdm.close("id_out");
+  },
+};
+
+const Menu = {
+  init() {
+    // gestione menu
+    const btn = document.querySelector("#id-menu-btn");
+    btn.addEventListener("change", () => {
+      document.querySelector("body").classList.toggle("menu-open", btn.checked);
+    });
+    // getsioe log
+    const log = document.getElementById("id_log");
+
+    const show = () => {
+      if (log.classList.contains("active")) return;
+      log.classList.add("active");
+    };
+
+    const hide = () => {
+      if (!log.classList.contains("active")) return;
+      log.classList.remove("active");
+    };
+    UaLog.callHide = hide;
+    UaLog.callShow = show;
+
+    UaLog.setXY(64, 13).setZ(111).new();
+    UaLog.log_show("Buon Lavoro");
+  },
+  close() {
+    const btn = document.querySelector("#menu-toggle");
+    document.querySelector("body").classList.remove("menu-open", btn.checked);
+    document.querySelector(".menu-btn").checked = false;
+  },
+  async help() {
+    const text = await requestGet("./help0.html");
+    wnds.wdiv.show(text);
+  },
+  upload() {
+    RagUpload.open();
+  },
+  uploadDir() {
+    RagUpload.openDir();
+  },
+  async load() {
+    alert("load");
+  },
+  log() {
+    UaLog.toggle();
+  },
+};
+
+
+const TextInput = {
+  wnd: null,
+  init() {
+    this.inp = document.querySelector(".text-input");
+    document.addEventListener("keydown", (e) => {
+      if (document.activeElement !== this.inp) {
+        const allowedKeys = [
+          "F1",
+          "F2",
+          "F3",
+          "F4",
+          "F5",
+          "F6",
+          "F7",
+          "F8",
+          "F9",
+          "F10",
+          "F11",
+          "F12",
+          "Control",
+          "Alt",
+          "Shift",
+          "Meta",
+          "CapsLock",
+          "Escape",
+          "PrintScreen",
+          "ScrollLock",
+          "Pause",
+          "Insert",
+          "Delete",
+          "Home",
+          "End",
+          "PageUp",
+          "PageDown",
+          "ArrowLeft",
+          "ArrowRight",
+          "ArrowUp",
+          "ArrowDown",
+        ];
+        if (!allowedKeys.includes(e.key) && !e.ctrlKey && !e.metaKey) {
+          e.preventDefault();
+        }
+      }
+    });
+
+    const clsBtn = document.querySelector(".clear-button");
+    clsBtn.addEventListener("click", () => {
+      this.inp.value = "";
+      this.inp.focus();
+    });
+    // this.inp.addEventListener("keydown", (e) => this.handleEnter(e));
+    document.querySelector(".send-input").addEventListener("click", () => this.send());
+    document.querySelector(".send2-input").addEventListener("click", () => this.send2());
+    document.querySelector(".clear-input").addEventListener("click", () => this.clear());
+  },
+  handleEnter(e) {
+    // if (e.key === "Enter" && !e.shiftKey) {
+    //   e.preventDefault();
+    //   this.send();
+    // }
+  },
+
+  // legge i documenti dal DBlocale
+  // sala le risposte RAG
+  // crea il contesto
+  async send() {
+    const q=this.inp.value;
+    if (!q) {
+      alert("Ricorda di scrivere la Query  ");
+      return;
+    }
+    Rag.readFromDb();
+    if (!!Rag.ragContext) {
+      const ok = confirm("Vuoi iniziare una nuova elabrazione ?");
+      if (!ok) return "";
+    }
+    showSpinner();
+    setOutText("");
+    const msg = this.inp.value.trim();
+    try {
+      const txt = await Rag.requestDocsRAG(msg);
+      setOutText(txt);
+      this.inp.value = "";
+      UaLog.close();
+    } catch (err) {
+      const msg = `send\n${err}`;
+      xerror(msg);
+      alert(msg);
+      setOutText(msg);
+    }
+    hideSpinner();
+  },
+
+  // utiliza il contesto esistente
+  async send2() {
+    const q=this.inp.value;
+    if (!q) {
+      alert("Ricorda di scrivere la Query  ");
+      return;
+    }
+    showSpinner();
+    if (ThreadMgr.isFirst()) setOutText("");
+    const query = this.inp.value.trim();
+    try {
+      const text = await Rag.requestContext(query);
+      if (text == "") {
+        hideSpinner();
+        return;
+      }
+      setOutText(text);
+      this.inp.value = "";
+    } catch (err) {
+      const msg = `send2\n${err}`;
+      xerror(msg);
+      alert(msg);
+      setOutText(msg);
+    }
+    hideSpinner();
+  },
+  clear() {
+    const ok = confirm("Confermi cancellazione conversazione? ");
+    if (!ok) return;
+    this.inp.value = "";
+    setOutText("");
+    ThreadMgr.init();
+  },
+};
+
+//XXX const setOutText = (txt) => {
+//   let out = document.getElementById("id-text-out");
+//   const ht = `<div class="div-text">${txt}</div>`;
+//   out.innerHTML=ht;
+//   const pre = out.querySelector(".div-text");
+//   pre.scrollTop = pre.scrollHeight;
+// };
+
+
+const setOutText = (txt) => {
+  let out = document.getElementById("id-text-out");
+  const h = `<pre class="pre-text"></pre>`;
+  out.innerHTML = h;
+  const pre = out.querySelector(".pre-text");
+  pre.textContent = txt;
+  pre.scrollTop = pre.scrollHeight;
+};
+
+TextOutput = {
+  init() {
+    this.copyBtn = document.querySelector(".copy-output");
+    this.copyBtn.addEventListener("click", () => this.copy());
+    const clearBtn = document.querySelector(".clear-output");
+    clearBtn.addEventListener("click", () => this.clear());
+    const wndBtn = document.querySelector(".wnd-output");
+    wndBtn.addEventListener("click", () => this.openWnd());
+  },
+  openWnd() {
+    const p = document.getElementById("id-text-out");
+    const s = p.textContent;
+    wnds.wout.show(s);
+  },
+  async copy() {
+    const e = document.getElementById("id-text-out");
+    const pre = e.querySelector("pre");
+    if (!pre) return;
+    const t = pre.textContent;
+    pre.classList.add("copied");
+    this.copyBtn.classList.add("copied");
+    try {
+      await navigator.clipboard.writeText(t);
+    } catch (err) {
+      xerror("Errore  ", err);
+    }
+    setTimeout(() => {
+      this.copyBtn.classList.remove("copied");
+      pre.classList.remove("copied");
+    }, 5000);
+  },
+  clear() {
+    const out = document.getElementById("id-text-out");
+    out.textContent = "";
+  },
+};

static/javascript/rag_upload.js

@@ -0,0 +1,215 @@
+/** @format */
+
+"use strict";
+
+const RagUpload = {
+  open() {
+    const htmlContent = `
+      <div class="window-text">
+        <div class="btn-wrapper">
+          <button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>
+        </div>     
+        <div class="upload">     
+          <h4>Upload file Text / PDF</h4>    
+          <form id="uploadForm">
+              <input class="file" type="file" id="id_fileupload" >   
+              <button type="button" onclick="RagUpload.upload();">Upload and Convert</button>
+          </form>
+          <div id="result" class="result"></div>
+        </div>
+      </div>
+    `;
+    const uploadWindow = UaWindowAdm.create("id_upload");
+    uploadWindow.drag();
+    uploadWindow.setZ(12);
+    uploadWindow.vw_vh().setXY(16.5, 10, -1);
+    uploadWindow.setHtml(htmlContent);
+    uploadWindow.show();
+  },
+  async upload() {
+    const fileInput = document.getElementById("id_fileupload");
+    const file = fileInput.files[0];
+    if (!file) {
+      alert("Nessun file selezionato.");
+      return;
+    }
+    const fileName = file.name;
+    const exist = DataMgr.doc_names.includes(fileName);
+    if (exist) {
+      alert("Il file è già in archivio");
+      return;
+    }
+
+    const result = document.getElementById("result");
+    const fileExtension = file.name.split(".").pop().toLowerCase();
+    showSpinner();
+    try {
+      let text;
+      if (fileExtension === "pdf") {
+        const pdfHandler = new PdfHandler();
+        await pdfHandler.loadPdfJs();
+        text = await pdfHandler.extractTextFromPDF(file);
+        pdfHandler.cleanup();
+      } else if (fileExtension === "txt") {
+        text = await readTextFile(file);
+      } else {
+        alert("Formato file non supportato.");
+        return;
+      }
+      DataMgr.addDoc(fileName, text);
+      const msg = `<br><br> ${fileName}<br><br>caricato e salvato nella memoria locale`;
+      result.innerHTML = msg;
+    } catch (error) {
+      console.error("Error:", error);
+      alert("Errore durante l'estrazione del testo dal file.");
+    } finally {
+      hideSpinner();
+    }
+  },
+  openDir() {
+    const htmlContent = `
+      <div class="window-text">
+        <div class="btn-wrapper">
+          <button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>
+        </div>     
+        <div class="upload">     
+          <h4>Upload files Text / PDF</h4>    
+          <form id="uploadForm">
+              <input id="id_fileupload" class="file" type="file"  webkitdirectory mozdirectory msdirectory odirectory directory multiple />
+              <button type="button" onclick="RagUpload.uploadDir();">Upload and Convert</button>
+          </form>
+          <div class="result" id="result"></div>
+        </div>
+      </div>
+    `;
+    const uploadWindow = UaWindowAdm.create("id_upload");
+    uploadWindow.drag();
+    uploadWindow.setZ(12);
+    uploadWindow.vw_vh().setXY(16.5, 10, -1);
+    uploadWindow.setHtml(htmlContent);
+    uploadWindow.show();
+  },
+
+  async uploadDir() {
+    const fileInput = document.getElementById("id_fileupload");
+    const files = fileInput.files;
+
+    if (!files || files.length == 0) {
+      alert("Nessun file selezionato.");
+      return;
+    }
+    const msgs = [];
+
+    showSpinner();
+
+    try {
+      for (const file of files) {
+        const fileName = file.name;
+        UaLog.log_show(fileName);
+        const exist = DataMgr.doc_names.includes(fileName);
+        if (exist) {
+          UaLog.log_shw(fileName + " : è già in archivio");
+          continue;
+        }
+        const fileExtension = file.name.split(".").pop().toLowerCase();
+        let text;
+        if (fileExtension === "pdf") {
+          const pdfHandler = new PdfHandler();
+          await pdfHandler.loadPdfJs();
+          text = await pdfHandler.extractTextFromPDF(file);
+          pdfHandler.cleanup();
+        } else if (fileExtension === "txt") {
+          text = await readTextFile(file);
+        } else {
+          alert("Formato file non supportato.");
+          return;
+        }
+        DataMgr.addDoc(fileName, text);
+        const msg = `${fileName}`;
+        msgs.push(msg);
+      }
+    } catch (error) {
+      console.error("Error:", error);
+      alert("Errore durante l'estrazione del testo dal file.");
+    } finally {
+      hideSpinner();
+    }
+
+    const result = document.getElementById("result");
+    const msg = msgs.join("<br>");
+    result.innerHTML = msg;
+  },
+};
+
+class PdfHandler {
+  constructor() {
+    this.pdfjsLib = null;
+    this.scriptElement = null;
+    this.workerScriptElement = null;
+  }
+
+  async loadPdfJs() {
+    if (window["pdfjsLib"]) {
+      this.pdfjsLib = window["pdfjs-dist/build/pdf"];
+      this.pdfjsLib.GlobalWorkerOptions.workerSrc = "https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.worker.min.js";
+      return;
+    }
+    // Carica pdf.js dinamicamente
+    this.scriptElement = document.createElement("script");
+    this.scriptElement.src = "https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.min.js";
+    document.body.appendChild(this.scriptElement);
+
+    // Aspetta che il worker sia caricato
+    await new Promise((resolve) => {
+      this.scriptElement.onload = () => {
+        this.workerScriptElement = document.createElement("script");
+        this.workerScriptElement.src = "https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.worker.min.js";
+        document.body.appendChild(this.workerScriptElement);
+        this.workerScriptElement.onload = resolve;
+      };
+    });
+
+    this.pdfjsLib = window["pdfjs-dist/build/pdf"];
+    this.pdfjsLib.GlobalWorkerOptions.workerSrc = "https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.worker.min.js";
+  }
+
+  async extractTextFromPDF(file) {
+    const arrayBuffer = await file.arrayBuffer();
+    const pdf = await this.pdfjsLib.getDocument({ data: arrayBuffer }).promise;
+    let text = "";
+    for (let i = 1; i <= pdf.numPages; i++) {
+      const page = await pdf.getPage(i);
+      const textContent = await page.getTextContent();
+      const pageText = textContent.items.map((item) => item.str).join(" ");
+      text += pageText + "\n";
+    }
+    return text;
+  }
+
+  cleanup() {
+    if (this.scriptElement) {
+      document.body.removeChild(this.scriptElement);
+      this.scriptElement = null;
+    }
+    if (this.workerScriptElement) {
+      document.body.removeChild(this.workerScriptElement);
+      this.workerScriptElement = null;
+    }
+    this.pdfjsLib = null;
+    if (window.gc) {
+      window.gc();
+    }
+  }
+}
+
+async function readTextFile(file) {
+  if (!file || file.type !== "text/plain") {
+    throw new Error("Invalid file type. Please select a text file.");
+  }
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = (event) => resolve(event.target.result);
+    reader.onerror = (error) => reject(new Error("Error reading file: " + error.message));
+    reader.readAsText(file);
+  });
+}

static/javascript/uadrag.js

@@ -0,0 +1,51 @@
+// jshint esversion: 8
+// release 24-04-2022
+
+
+const nodrag_tds = ['input', 'select', 'a'];
+const nodrag_cls = "nodrag";
+
+var UaDrag = function (e) {
+    const drag = function (element) {
+        let pos1 = 0,
+            pos2 = 0,
+            pos3 = 0,
+            pos4 = 0;
+
+        const dragMouseDown = function (e) {
+            e = e || window.event;
+            let t = e.target;
+            t = t || null;
+            if (!t) return;
+            if (nodrag_tds.includes(t.tagName.toLowerCase())) return;
+            if (t.classList.contains(nodrag_cls)) return;
+            e.preventDefault();
+            //e.stopImmediatePropagation();
+            pos3 = e.clientX;
+            pos4 = e.clientY;
+            document.onmouseup = closeDragElement;
+            document.onmousemove = elementDrag;
+        };
+
+        const elementDrag = function (e) {
+            e = e || window.event;
+            //e.stopImmediatePropagation();
+            e.preventDefault();
+            pos1 = pos3 - e.clientX;
+            pos2 = pos4 - e.clientY;
+            pos3 = e.clientX;
+            pos4 = e.clientY;
+            element.style.top = (element.offsetTop - pos2) + "px";
+            element.style.left = (element.offsetLeft - pos1) + "px";
+        };
+
+        const closeDragElement = function () {
+            document.onmouseup = null;
+            document.onmousemove = null;
+        };
+
+        element.onmousedown = dragMouseDown;
+    };
+    return drag(e);
+};
+

static/javascript/uajtfh.js

@@ -0,0 +1,25 @@
+/** @format */
+const UaJtfh = () => {
+  return {
+    rows: [],
+    init() {
+      this.rows = [];
+      return this;
+    },
+    insert(s) {
+      this.rows.unshift(s);
+      return this;
+    },
+    append(s) {
+      this.rows.push(s);
+      return this;
+    },
+    text(ln = "") {
+      return this.rows.join(ln);
+    },
+    html(ln = "") {
+      const h = this.rows.join(ln).replace(/\s+|\[rn\]/g, " ");
+      return h;
+    },
+  };
+};

static/javascript/ualog.js

@@ -0,0 +1,157 @@
+/** @format */
+// function show() {
+//   const log = document.getElementById("id_log");
+//   if (log.classList.contains("active")) return;
+//   log.classList.add("active");
+// }
+
+// function hide() {
+//   const log = document.getElementById("id_log");
+//   if (!log.classList.contains("active")) return;
+//   log.classList.remove("active");
+// }
+// jshint esversion: 8
+// release 09-'6-24
+// utilizzare l'ultima versione di UaWindowAdm
+// setXY con vw ,vh
+var UaLog = {
+  callHide: function () {},
+  callShow: function () {},
+  active: false,
+  wind: null,
+  x: null,
+  y: null,
+  z: null,
+  max_length: 2000,
+  msg_id: "ualogmsg_",
+  new: function () {
+    if (this.wind == null) {
+      this.wind = UaWindowAdm.create("ualog_");
+      this.wind.drag();
+    }
+    const h = `
+         <button type="button" onclick="javascript:UaLog.cls();">Clear</button>
+         <button type="button" onclick="javascript:UaLog.close();">Close</button>
+         <div id="ualogmsg_"></div>`;
+    this.wind.setHtml(h);
+    this.wind.setStyle({
+      width: "auto",
+      minWidth: "300px",
+      maxWidth: "400px",
+      height: "auto",
+      textAlign: "center",
+      padding: "2px 2px 2px 2px",
+      margin: "5px 0 0 0",
+      // background: "#111111",
+      background: "#333333",
+      color: "#ffffff",
+      fontSize: "15px",
+      fontWeight: "normal",
+      borderRadius: "9px",
+      border: "1px solid #999999",
+    }); 
+
+    const msg = document.getElementById(this.msg_id);
+    const msg_css = {
+      width: "auto",
+      textAlign: "left",
+      fontSize: "16px",
+      fontFamily:"monospace",
+      paddingTop: "2px ",
+      marginTop: "2px",
+      color: "inherit",
+      // background: "#444444",
+      background: "#000000",
+      maxHeight: "600px",
+      overflow: "auto",
+      scrollbarColor: "#ab3205 #ffffff",
+      scrollbarWidth: "auto",
+    };
+    for (const k in msg_css) msg.style[k] = msg_css[k];
+
+    const btn_css = {
+      background: "#444444",
+      color: "#ffffff",
+      padding: "5px 5px 5px 5px",
+      margin: "0 5px 0 5px",
+      fontSize: "16px",
+      fontWeight: "bold",
+      border: "1px solid #ffffff",
+      borderRadius: "10px",
+    };
+    const btns = document.querySelectorAll("#ualog_  button");
+    for (const b of btns) {
+      for (const k in btn_css) b.style[k] = btn_css[k];
+      b.addEventListener("mouseover", (e) => {
+        e.target.style.cursor = "pointer";
+        e.target.style.color = "#000000";
+        e.target.style.background = "#aaaaaa";
+      });
+      b.addEventListener("mouseout", (e) => {
+        for (const k in btn_css) e.target.style[k] = btn_css[k];
+      });
+    }
+    if (!!this.x) this.wind.vw_vh().setXY(this.x, this.y, -1);
+    else this.wind.setCenter(-1);
+    if (!!this.z) this.wind.setZ(this.z);
+    return this;
+  },
+  setXY(x, y) {
+    this.x = x;
+    this.y = y;
+    return this;
+  },
+  setZ(z) {
+    this.z = z;
+    return this;
+  },
+  prn_(...args) {
+    let s = args.join("<br/>");
+    let e = document.getElementById(this.msg_id);
+    let h = e.innerHTML + s + "<br/>";
+    if (h.length > this.max_length) h = h.slice(-this.max_length);
+    e.innerHTML = h;
+  },
+  print(...args) {
+    if (this.wind == null) return;
+    if (!this.active) return;
+    this.prn_(...args);
+  },
+  log(...args) {
+    if (this.wind == null) return;
+    this.prn_(...args);
+  },
+  log_show(...args) {
+    if (this.wind == null) return;
+    if (!this.active) this.toggle();
+    this.prn_(...args);
+  },
+  cls() {
+    if (this.wind == null) return;
+    document.getElementById(this.msg_id).innerHTML = "";
+    return this;
+  },
+  close() {
+    if (this.wind == null) return;
+    this.wind.hide();
+    this.active = false;
+    this.callHide();
+  },
+  // open() {
+  //   if (this.wind == null) return;
+  //   this.wind.show();
+  //   this.active = true;
+  // },
+  toggle() {
+    if (this.wind == null) return;
+    if (!this.active) {
+      this.active = true;
+      this.wind.show();
+      this.callShow();
+    } else {
+      this.active = false;
+      this.wind.hide();
+      this.callHide();
+    }
+  },
+};

static/javascript/uawindow.js

@@ -0,0 +1,211 @@
+/** @format */
+
+// jshint esversion: 8
+// release 03-05-24
+"use strict";
+
+var UaWindowAdm = {
+  ws: {},
+  create(id, parent_id = null) {
+    let w = document.getElementById(id);
+    if (!w) {
+      w = document.createElement("div");
+      if (!parent_id) document.body.appendChild(w);
+      else document.getElementById(parent_id).appendChild(w);
+      w.id = id;
+      w.setAttribute("data-name", "ua-window");
+      const uaw = this.newUaWindow(w);
+      this.ws[id] = uaw;
+    }
+    const uaw = this.ws[id];
+    w.style.display = "none";
+    return uaw;
+  },
+  get(id) {
+    if (!this.ws[id]) return null;
+    return this.ws[id];
+  },
+  show(id) {
+    if (!!this.ws[id]) this.ws[id].show();
+  },
+  close(id) {
+    if (!!this.ws[id]) this.ws[id].close();
+  },
+  toggle(id) {
+    if (!!this.ws[id]) this.ws[id].toggle();
+  },
+  hide(id) {
+    if (!!this.ws[id]) this.ws[id].hide();
+  },
+  closeThis(e) {
+    const ancestor = e.closest('[data-name="ua-window"]');
+    const id = ancestor.id;
+    this.ws[id].close();
+  },
+  showAll() {
+    for (let k in this.ws) this.ws[k].show();
+  },
+  hideAll() {
+    for (let k in this.ws) this.ws[k].hide();
+  },
+  closeAll() {
+    for (let k in this.ws) this.ws[k].close();
+  },
+  remove(id) {
+    if (!this.ws[id]) return;
+    document.getElementById(id).remove();
+    this.ws[id] = null;
+    delete this.ws[id];
+  },
+  removeAll() {
+    for (let k in this.ws) this.remove(k);
+    this.ws = {};
+  },
+  newUaWindow(jqw) {
+    let wnd = {
+      initialize(w) {
+        this.w = w;
+        this.wx = "0px";
+        this.wy = "0px";
+        this.isOpen = false;
+        this.isVisible = false;
+        this.firstShow = true;
+        this.pos = 0;
+        this.wz = 0;
+        this.vw = "px";
+        this.vh = "px";
+      },
+      vw_vh() {
+        // setta coe unità di misura vw e vh al posto di px;
+        this.vw = "vw";
+        this.vh = "vh";
+        return this;
+      },
+      addClassStyle(className) {
+        if (!this.w.classList.contains(className)) this.w.classList.add(className);
+        return this;
+      },
+      removeClassStyle(className) {
+        if (this.w.classList.contains(className)) this.w.classList.remove(className);
+        return this;
+      },
+      getWindow() {
+        alert("getWindow => ??");
+        return this.w;
+      },
+      getElement() {
+        return this.w;
+      },
+      getId() {
+        return this.w.id;
+      },
+      setStyle(styles) {
+        for (const prop in styles) this.w.style[prop] = styles[prop];
+        return this;
+      },
+      setHtml(html) {
+        this.w.innerHTML = html;
+        return this;
+      },
+      getHtml() {
+        return this.w.innerHTML;
+      },
+      /*
+            pos==1) => si posiziona ad ogni chiamata di show
+            pos==0) => si posiziona ad ogni chiamata di show
+                        sucessiva ad uno status hide (default)
+            pos==-1)=> si posiziona solo alla prima chiamata di show
+
+            x => 0      left=x
+            x < 0       right=abs(x)
+            */
+      setXY(x, y, pos = 0) {
+        this.wx = x;
+        this.wy = y;
+        this.pos = pos;
+        return this;
+      },
+      setCenterY(y, pos) {
+        let xd = window.innerWidth;
+        const wd = this.w.clientWidth;
+        let x = (xd - wd) / 2;
+        this.setXY(x, y, pos);
+        return this;
+      },
+      setCenter(pos) {
+        let xd = window.innerWidth;
+        let yd = window.innerHeight;
+        const wd = this.w.clientWidth;
+        const wh = this.w.clientHeight;
+        let x = (xd - wd) / 2;
+        let y = (yd - wh) / 2;
+        this.setXY(x, y, pos);
+        return this;
+      },
+      linkToId(linked_id, dx, dy, pos) {
+        let lk = document.getElementById(linked_id);
+        this.linkToElement(lk, dx, dy, pos);
+        return this;
+      },
+      linkToElement(elm, dx, dy, pos) {
+        let x = elm.offsetLeft + elm.offsetWidth + dx;
+        let y = elm.offsetTop + dy;
+        if (y < 0) y = 0;
+        this.setXY(x, y, pos);
+        return this;
+      },
+      setZ(z) {
+        this.wz = z;
+        return this;
+      },
+      reset() {
+        this.firstShow = true;
+        return this;
+      },
+      toggle() {
+        if (!this.isVisible) this.show();
+        else this.hide();
+        return this;
+      },
+      show() {
+        if (this.firstShow || this.pos == 1 || (this.pos === 0 && this.isVisible === false)) {
+          this.w.style.position = "absolute";
+          this.w.style.marginLeft = 0;
+          this.w.style.marginTop = 0;
+          this.w.style.top = `${this.wy}${this.vh}`;
+          if (this.wx >= 0) this.w.style.left = `${this.wx}${this.vw}`;
+          else this.w.style.right = -`${this.wx}${this.vw}`;
+          if (this.wz > 0) this.w.style.zIndex = this.wz;
+        }
+        this.w.style.display = "";
+        this.firstShow = false;
+        this.isVisible = true;
+        this.isOpen = true;
+        return this;
+      },
+      hide() {
+        this.w.style.display = "none";
+        this.isVisible = false;
+        return this;
+      },
+      close() {
+        this.w.style.display = "none";
+        this.w.innerHTML = "";
+        // this.w.innerHTML = "block";
+        this.isOpen = false;
+        return this;
+      },
+      remove() {
+        const id = this.w.id;
+        UaWindowAdm.remove(id);
+        return null;
+      },
+      drag() {
+        UaDrag(this.w);
+        return this;
+      },
+    };
+    wnd.initialize(jqw);
+    return wnd;
+  },
+};

static/js/ragrqs.min.js

@@ -0,0 +1,176 @@
+function cleanDoc(a){a=a.split("\n").map(function(b){return b.replace(/[\x00-\x1F\x7F-\x9F\u200B-\u200D\uFEFF]/g,"")}).join("\n");a=a.replace(/\t/g," ");a=a.replace(/ +/g," ");a=a.split("\n").map(b=>b.trim()).join("\n");a=a.replace(/\n\s*\n/g,"\n\n");a=a.replace(/["""]/g,'"').replace(/['']/g,"'");a=a.replace(/[\u2013\u2014]/g,"-");a=a.replace(/\\[nrt]/g,"");a=a.replace(/[^\p{L}\p{N}\s\.,;:!?'"()\-]/gu,"");a=a.replace(/ +([.,;:!?])/g,"$1");return a.trim()}
+function list2text(a){return text=a.map(b=>`${b.trim()}`).join("\n")}function cleanOutput(a){a=a.trim();a=a.replace(/\n{3,}/g,"\n\n");a=a.replace(/^[ \t]+/gm,"");a=a.replace(/^(\s*[-*\u2022])(\s*)/gm,"\n$1 ");a=a.replace(/^(\s*\d+\.)(\s*)/gm,"\n$1 ");a=a.replace(/(```[\s\S]*?```)/g,"\n\n$1\n\n");return a=a.replace(/[ \t]+$/gm,"")};const UaDb={create(a,b){localStorage.getItem(a)?xerror(`ID ${a} already exists.`):localStorage.setItem(a,b)},read(a){const b=localStorage.getItem(a);return null===b?(xlog(`UaDb.read  ${a} not found.`),""):b},update(a,b){localStorage.getItem(a)?localStorage.setItem(a,b):xlog(`UaDb.update ${a} not found.`)},delete(a){localStorage.getItem(a)?localStorage.removeItem(a):xerror(`ID ${a} not found.`)},save(a,b){localStorage.setItem(a,b)},getAllIds(){const a=[];for(let b=0;b<localStorage.length;b++)a.push(localStorage.key(b));
+return a},saveArray(a,b){b=b.join("|");UaDb.save(a,b)},readArray(a){a=UaDb.read(a);return 0==a.trim().length?[]:a.split("|").map(b=>b.trim())},saveJson(a,b){b=JSON.stringify(b);UaDb.save(a,b)},readJson(a){return(a=UaDb.read(a))?JSON.parse(a):{}}},DataMgr={docs:[],doc_names:[],linkToName(a){a=a.split("/");return a[a.length-1]},async loadDoc(a){try{const b=await requestGet(a),c=cleanDoc(b),d=this.linkToName(a);this.doc_names.push(d);this.docs.push(c);this.saveDbDocs();return c}catch(b){alert("loadDoc()\n"+
+b+"\n"+a)}},addDoc(a,b){b=cleanDoc(b);this.docs.push(b);this.doc_names.push(a);this.saveDbDocs()},saveDbDocs(){UaDb.saveArray("id_doc_names",this.doc_names);UaDb.saveArray("id_docs",this.docs)},readDbDocs(){this.docs=UaDb.readArray("id_docs")},readDbDocNames(){this.doc_names=UaDb.readArray("id_doc_names")},deleteDati(){const a=UaDb.getAllIds();for(const b of a)["id_docs","id_doc_names"].includes(b)||UaDb.delete(b)}};const model_name="mistralai/Mistral-7B-Instruct-v0.3";function decodeTokenBase64(a){return atob(a)}const encodedToken="aGZfT0VBQVpoUmJtdEFLRENOVGZTcFZwVHdhbGpielBvQnlhbA",HF_TOKEN=decodeTokenBase64(encodedToken);
+async function requestGet(a){try{var b=await fetch(a,{method:"GET",headers:{"Content-Type":"text/plain;charset=UTF-8"}});if(!b.ok)throw Error(`HTTP error! status: ${b.status}`);const c=await b.arrayBuffer();return(new TextDecoder("utf-8")).decode(c)}catch(c){throw console.error(c),b="AbortError"===c.name?"Request was aborted":c.message.includes("HTTP error! status")?c.message:"An error occurred",alert(`requestGet()\nurl: ${a}\n${b}`),c;}}
+const ERROR_TOKENS="ERROR_TOKENS",TIMEOUT_ERROR="TIMEOUT_ERROR",HfRequest={controller:null,isCancelled:!1,baseUrl:"https://api-inference.huggingface.co/models",async post(a,b=3E4){this.isCancelled=!1;this.controller=new AbortController;try{const c=setTimeout(()=>{this.controller.abort()},b),d=await fetch(`${this.baseUrl}/${model_name}`,{method:"POST",headers:{Authorization:`Bearer ${HF_TOKEN}`,"Content-Type":"application/json"},body:JSON.stringify(a),signal:this.controller.signal});clearTimeout(c);
+if(this.isCancelled)return null;const e=await d.json();if(!d.ok){const h=this.checkError(d.status,e),l=this.createErrorInfo(d.status,d.statusText,e.error,h);throw Error(l);}const f=this.isInvalidResponse(e);if("string"===typeof f){const h=this.createErrorInfo(d.status,d.statusText,e.error,f);throw Error(h);}return e[0].generated_text.trim()}catch(c){if(this.isCancelled)return null;if("AbortError"===c.name)throw a=this.createErrorInfo(0,"Timeout","La richiesta \u00e8 scaduta",TIMEOUT_ERROR),Error(a);
+throw c;}},cancelRequest(){this.controller&&(this.isCancelled=!0,this.controller.abort())},checkError(a,b){return 500<=a?"SERVER_ERROR":400<=a&&500>a?"object"===typeof b&&"validation"===b.error_type?b.error.includes("tokens")?ERROR_TOKENS:"ERROR_VALIDATION":"CLIENT_ERROR":"UNKNOWN_ERROR"},isInvalidResponse(a){return a&&Array.isArray(a)&&0!==a.length?a[0].generated_text?null:"MISSING_GENERATED_TEXT":"INVALID_DATA"},createErrorInfo(a,b,c,d){return JSON.stringify({status:a,statusText:b,errorType:d,message:c||
+"Errore sconosciuto"})}};/*
+
+ rag_rqs
+ Copyright (C) 2024 [Il tuo nome]
+
+ 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/>.
+*/
+const MAX_PROMPT_LENGTH=90112,PROMPT_DECR=2048,Rag={ragContext:"",ragQuery:"",ragResponse:"",responses:[],prompts:[],doc:"",doc_part:"",saveToDb(){UaDb.saveJson("id_rag",{context:this.ragContext,ragquery:this.ragQuery,ragresponse:this.ragResponse})},readFromDb(){const a=UaDb.readJson("id_rag");this.ragContext=a.context||"";this.ragQuery=a.ragquery||"";this.ragResponse=a.ragresponse||""},saveRespToDb(){UaDb.saveArray("id_responses",this.responses)},readRespsFromDb(){this.responses=UaDb.readArray("id_responses")},
+addPrompt(a){this.prompts.push(a)},responsesLength(){return this.responses.reduce((a,b)=>a+b.length,0)},log(a,b,c){const d=MAX_PROMPT_LENGTH,e=this.responsesLength();xlog(`${a} mx:${d} lft:${b} rgt:${c} arr:${e}`);UaLog.log(`${a}${"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"}${b}${"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"}${c}${"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"}${e}`)},truncInput(a,b){return a.substring(0,a.length-b)},getPartSize(a,b,c){c=MAX_PROMPT_LENGTH-c;a.length+b.length<c?c=a.length:(a=a.indexOf(".",
+c),a=(-1!=a?a:c)+1,a>c+100&&(a=c),c=a);return c},getPartDoc(a,b){const c=a.substring(0,b);a=a.substring(b).trim();return[c,a]},errorInfo(a){return JSON.parse(a.message)},errorTotext(a){a=JSON.parse(a.message);return`Errore:
+    Stato: ${a.status}
+    Descrizione stato: ${a.statusText}
+    Tipo di errore: ${a.errorType}
+    Messaggio: ${a.message}`},async requestDocsRAG(a){ThreadMgr.init();DataMgr.deleteDati();DataMgr.readDbDocNames();DataMgr.readDbDocs();this.ragQuery=a;this.ragResponse=this.ragContext="";this.responses=[];this.prompts=[];var b=0;try{for(let c=0;c<DataMgr.docs.length;c++){let d=DataMgr.docs[c];if(""==d.trim())continue;const e=DataMgr.doc_names[c],f=d.length;UaLog.log(`${e} (${f}) `);xlog(`${e} (${f}) `);++b;let h=0,l="",g="",k=0,n="";for(;;){let q=this.getPartSize(d,promptDoc("",a),k);if(10>q)break;
+[l,g]=this.getPartDoc(d,q);n=promptDoc(l,a);const r=getPayloadDoc(n);let m;try{if(m=await HfRequest.post(r),!m)return""}catch(p){if(this.errorInfo(p).errorType===ERROR_TOKENS){UaLog.log(`Error tokens.1  ${n.length}`);xlog(`Error tokens.  ${n.length}`);k+=PROMPT_DECR;continue}else throw xerror(p),this.errorTotext(p);}h++;d=g;1==h&&(m=`[[NOME_DOCUMENTO]]:${e}\n${m}`);this.responses.push(m);this.log(`${b},${h}`,l.length,g.length)}}}catch(c){alert("requestDocsRAG(1)\n"+c),xerror(c)}this.ragContext=list2text(this.responses);
+this.saveToDb();b="";try{let c=promptWithContext(this.ragContext,a);const d=getPayloadQuery(c);try{if(b=await HfRequest.post(d),!b)return""}catch(e){this.errorInfo(e);const f=this.errorTotext(e);xerror(e);throw f;}this.ragResponse=b;this.saveRespToDb();this.saveToDb();UaLog.log(`Risposta  (${c.length},${b.length})`)}catch(c){throw b=c,xerror(c),alert("requestDocsRAG(3)\n"+c),c;}finally{return b=cleanOutput(b)}},async requestContext(a){this.readFromDb();if(!this.ragContext&&!await confirm("Contesto vuoto. Vuoi continuare?"))return"";
+if(ThreadMgr.isFirst()){var b="";try{var c=promptWithContext(this.ragContext,a),d=getPayloadQuery(c);try{var e=await HfRequest.post(d);if(!e)return""}catch(f){throw this.errorInfo(f).errorType===ERROR_TOKENS?UaLog.log(`Error tokens.4  ${c.length}`):alert(f),xerror(f),f;}ThreadMgr.add(a,e);b=ThreadMgr.getOutText();UaLog.log(`Inizio Conversazione (${c.length},${e.length})`)}catch(f){throw xerror(f),b=f,f;}finally{return b=cleanOutput(b)}}else{c="";try{b=this.ragContext;let f=ThreadMgr.getThread();e=
+d="";let h=0;for(;;){f=this.truncInput(f,h);d=promptThread(b,f,a);const l=getPayloadQuery(d);try{if(e=await HfRequest.post(l),!e)return""}catch(g){const k=this.errorInfo(g);if(k.errorType===ERROR_TOKENS){UaLog.log(`Error tokens.5  ${d.length}`);xlog(`Error tokens.  ${d.length}`);h+=PROMPT_DECR;continue}else throw xerror(g),k.errorType;}break}ThreadMgr.add(a,e);c=ThreadMgr.getOutText();UaLog.log(`Conversazione  (${d.length},${e.length})`)}catch(f){throw alert("requestContext(2) \n"+f),xerror(f),c=
+f,f;}finally{return c=cleanOutput(c)}}}},ThreadMgr={rows:[],init(){this.rows=[]},add(a,b){this.rows.push([a,b])},getOutText(){const a=[];for(const b of this.rows){const c=b[0].trim(),d=b[1].trim();a.push(`<user>:\n${c}\n<Assistant>:\n${d}\n\n`)}return a.join("").trim()},getThread(){const a=[];for(const b of this.rows){const c=b[0].trim(),d=b[1].trim();a.push(`<user>:\n${c}\n<Assitant>:\n${d}\n\n`)}return a.join("").trim()},isFirst(){return 0==this.rows.length}};function promptDoc(a,b){return`
+[[RUOLO]]
+Analista di documenti esperto nell'estrazione di informazioni pertinenti.
+
+[[COMPITO]]
+Analizza il documento e estrai le informazioni rilevanti per la domanda.
+
+[[DOCUMENTO]]
+${a}
+
+[[DOMANDA]]
+${b}
+
+[[ISTRUZIONI]]
+1. Identifica i concetti chiave e sintetizzali per fornire una risposta completa.
+2. Assicurati di organizzare le informazioni in modo chiaro e logico.
+3. Conserva le informazioni contrastanti, se presenti, senza tentare di risolverle.
+4. Puoi fare inferenze ragionevoli basate sulle informazioni fornite.
+5. Includi citazioni o riferimenti specifici al documento solo se necessari per chiarire la descrizione.
+
+[[OUTPUT]]
+Elenco delle informazioni identificate, incluse eventuali inferenze
+`}function promptToContext(a){return`
+[[RUOLO]]
+Esperto di analisi semantica delle informazioni.
+
+[[OBIETTIVO]]
+Unificare le informazioni semanticamente equivalenti da vari documenti.
+
+[[ELENCO_RISPOSTE]]
+${a}
+
+[[ISTRUZIONI]]
+1. Analizza le informazioni dell'elenco risposte.
+2. Per ogni documento raggruppa le informazioni sulla base del loro significato.
+3. Presenta le informazioni in modo chiaro e coerente.
+
+[[OUTPUT]]
+Elenco delle informazioni mantenendo la divisione per documento.
+`}function promptWithContext(a,b){return`
+[[COMPITO]]
+Elabora una risposta esaustiva e pertinente alla domanda basata sul contesto fornito.
+
+[[CONTESTO]]
+${a}
+
+[[DOMANDA]]
+${b}
+
+[[ISTRUZIONI]]
+1. Analizza attentamente il contesto e la domanda posta.
+2. Struttura una risposta logica, coerente e completa.
+3. Utilizza le informazioni del contesto, citando i documenti di origine solo se necessario per chiarire la descrizione.
+4. Evidenzia le connessioni tra i vari concetti e le fonti.
+5. Includi inferenze ragionevoli.
+
+[[OUTPUT]]
+L'output \u00e8 destinato ad essere letto da un lettore italiano.
+`}function promptThread(a,b,c){return`
+[[COMPITO]]
+Rispondi alla nuova domanda integrando il contesto iniziale e gli sviluppi della conversazione in corso.
+
+[[CONTESTO]]
+${a}
+
+[[CONVERSAZIONE]]
+${b}
+
+[[DOMANDA]]
+${c}
+
+[[ISTRUZIONI]]
+1. Analizza la nuova domanda nel contesto della conversazione in corso.
+2. Integra le informazioni dal contesto iniziale con gli sviluppi della discussione.
+3. Mantieni la coerenza con la conversazione precedente, evitando ripetizioni non necessarie.
+4. Puoi fare inferenze ragionevoli.
+5. Adatta la risposta alla domanda attuale, anche se si discosta dal tema principale della conversazione.
+6. Usa citazioni o riferimenti solo se necessario per chiarire la descrizione.
+
+[[OUTPUT]]
+L'output \u00e8 destinato ad essere letto da un lettore italiano.
+`}
+const getPayloadDoc=a=>({inputs:a,parameters:{task:"text2text-generation",max_new_tokens:512,num_return_sequences:1,temperature:.6,top_k:50,top_p:.85,do_sample:!0,no_repeat_ngram_size:4,num_beams:6,repetition_penalty:1.2,return_full_text:!1,details:!1,max_time:90,seed:42},options:{use_cache:!1,wait_for_model:!0}}),getPlayloadContext=a=>({inputs:a,parameters:{task:"text2text-generation",max_new_tokens:1024,num_return_sequences:1,temperature:.8,top_k:50,top_p:.85,do_sample:!0,no_repeat_ngram_size:3,num_beams:5,
+repetition_penalty:1.1,return_full_text:!1,details:!1,max_time:120,seed:42},options:{use_cache:!1,wait_for_model:!0}}),getPayloadQuery=a=>({inputs:a,parameters:{task:"text-generation",max_new_tokens:512,num_return_sequences:1,temperature:.7,top_k:50,top_p:.85,do_sample:!0,no_repeat_ngram_size:3,num_beams:5,repetition_penalty:1.4,return_full_text:!1,details:!1,max_time:120,seed:42},options:{use_cache:!1,wait_for_model:!0}});const VERS="0.1.33 (16-07-2024)";var xlog=console.log,xerror=console.error;const cancelRequest=()=>{confirm("Confermi Cancellazione Richeista ?")&&(HfRequest.cancelRequest(),hideSpinner())},showSpinner=()=>{const a=document.getElementById("spinner");a.classList.add("show-spinner");a.addEventListener("click",cancelRequest)},hideSpinner=()=>{const a=document.getElementById("spinner");a.classList.remove("show-spinner");a.removeEventListener("click",cancelRequest)};
+function openApp(){wnds.init();Menu.init();TextInput.init();TextOutput.init();document.querySelector(".menu-btn").checked=!1;release()}function release(){document.querySelector(".release").innerHTML=VERS}const op0=async function(a){a=await requestGet("./help1.html");wnds.wdiv.show(a)};function op1(a){Rag.readFromDb();wnds.wpre.show(`\n${Rag.ragQuery}`)}function showRagResponse(a){Rag.readFromDb();wnds.wpre.show(`\n${Rag.ragResponse}`)}
+function op2(a){a=[...Rag.responses];0==a.length&&(a=UaDb.readArray("id_responses"));0!=a.length&&(a=a.map((b,c)=>`[${c+1}]\n ${b.trim()}`).join("\n"),wnds.wpre.show(a))}function op3(a){Rag.readFromDb();wnds.wpre.show(`${Rag.ragContext}`)}function op4(a){var b=UaDb.getAllIds();a=[];for(var c of b)b=UaDb.read(c).length,a.push(`${c} (${b})`);c=a.join("\n ");wnds.wpre.show(c)}async function op5(a){DataMgr.readDbDocNames();a=DataMgr.doc_names.join("\n");wnds.wpre.show(a)}
+function calcQuery(){DataMgr.readDbDocs();DataMgr.readDbDocNames();var a=[];let b=0,c=0;a.push("Documento   Num.Parti");a.push("==================");for(const d of DataMgr.docs){const e=DataMgr.doc_names[c];c+=1;const f=Math.ceil(d.length/MAX_PROMPT_LENGTH);b+=f;a.push(`${e}&nbsp;&nbsp;&nbsp;[${f}]`)}a.push("==================");a.push(`Totale num. Parti: ${b}`);a=a.join("\n");wnds.wpre.show(a)}
+function op7(a){confirm("Confermi cancellazione dati?")&&(DataMgr.deleteDati(),Rag.ragContext="",Rag.ragQuery="",Rag.responses=[],wnds.wdiv.close(),wnds.wpre.close(),TextOutput.clear())}function op8(a){confirm("Confermi cancellazione documenti & dati?")&&(localStorage.clear(),Rag.ragContext="",Rag.ragQuery="",Rag.responses=[],wnds.wdiv.close(),wnds.wpre.close(),TextOutput.clear(),DataMgr.docs=[],DataMgr.doc_names=[])}
+function op9(a){0!=Rag.prompts.length&&(a=Rag.prompts.map((b,c)=>`[${c+1}]${b}\n`).join("\n"),wnds.wpre.show(a))}function op6(a){DataMgr.readDbDocs();a=DataMgr.docs.join("\n");wnds.wpre.show(a)}async function help1(a){a=await requestGet("./data/help_test.html");wnds.wdiv.show(a)}function esempio(a){DataMgr.loadDoc(`data/${a}`);wnds.wdiv.close()}async function help2(a){a=await requestGet("./help2.html");wnds.wdiv.show(a)};const WndPre=a=>({w:UaWindowAdm.create(a),out:null,show(b){wnds.closeAll();b=`
+<div class="window-text">
+<div class="btn-wrapper">
+<button class="btn-copy" title="Copia">
+<svg class="copy-icon" viewBox="0 0 20 24">
+  <path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
+</svg>
+</button>
+<button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>
+</div>
+<pre class="pre-text">${b}</pre>
+</div>
+    `;this.w.drag();this.w.setZ(12);this.w.vw_vh().setXY(16.5,10,-1);this.w.setHtml(b);this.w.show();this.w.getElement().querySelector(".btn-copy").addEventListener("click",()=>this.copy())},close(){this.w.close()},async copy(){const b=this.w.getElement().querySelector(".pre-text").textContent;try{await navigator.clipboard.writeText(b)}catch(c){xerror("Errore  ",c)}}}),WndDiv=a=>({w:UaWindowAdm.create(a),out:null,show(b){wnds.closeAll();b=`
+<div class="window-text">
+<div class="btn-wrapper">
+<button class="btn-copy" title="Copia">
+<svg class="copy-icon" viewBox="0 0 20 24">
+<path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
+</svg>
+</button>
+<button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>
+</div>
+<div class="div-text">${b}</div>
+</div>
+    `;this.w.drag();this.w.setZ(12);this.w.vw_vh().setXY(16.5,10,-1);this.w.setHtml(b);this.w.show();this.w.getElement().querySelector(".btn-copy").addEventListener("click",()=>this.copy())},close(){this.w.close()},async copy(){const b=this.w.getElement().querySelector(".div-text").textContent;try{await navigator.clipboard.writeText(b)}catch(c){xerror("Errore  ",c)}}}),wnds={wdiv:null,wpre:null,wout:null,init(){this.wdiv=WndDiv("id_w0");this.wpre=WndPre("id_w1");this.wout=WndPre("id_out")},closeAll(){UaWindowAdm.close("id_w0");
+UaWindowAdm.close("id_w1");UaWindowAdm.close("id_out")}},Menu={init(){const a=document.querySelector("#id-menu-btn");a.addEventListener("change",()=>{document.querySelector("body").classList.toggle("menu-open",a.checked)});const b=document.getElementById("id_log");UaLog.callHide=()=>{b.classList.contains("active")&&b.classList.remove("active")};UaLog.callShow=()=>{b.classList.contains("active")||b.classList.add("active")};UaLog.setXY(64,13).setZ(111).new();UaLog.log_show("Buon Lavoro")},close(){const a=
+document.querySelector("#menu-toggle");document.querySelector("body").classList.remove("menu-open",a.checked);document.querySelector(".menu-btn").checked=!1},async help(){const a=await requestGet("./help0.html");wnds.wdiv.show(a)},upload(){RagUpload.open()},uploadDir(){RagUpload.openDir()},async load(){alert("load")},log(){UaLog.toggle()}},TextInput={wnd:null,init(){this.inp=document.querySelector(".text-input");document.addEventListener("keydown",a=>{document.activeElement!==this.inp&&("F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 Control Alt Shift Meta CapsLock Escape PrintScreen ScrollLock Pause Insert Delete Home End PageUp PageDown ArrowLeft ArrowRight ArrowUp ArrowDown".split(" ").includes(a.key)||
+a.ctrlKey||a.metaKey||a.preventDefault())});document.querySelector(".clear-button").addEventListener("click",()=>{this.inp.value="";this.inp.focus()});document.querySelector(".send-input").addEventListener("click",()=>this.send());document.querySelector(".send2-input").addEventListener("click",()=>this.send2());document.querySelector(".clear-input").addEventListener("click",()=>this.clear())},handleEnter(a){},async send(){if(this.inp.value){Rag.readFromDb();if(Rag.ragContext&&!confirm("Vuoi iniziare una nuova elabrazione ?"))return"";
+showSpinner();setOutText("");var a=this.inp.value.trim();try{const b=await Rag.requestDocsRAG(a);setOutText(b);this.inp.value="";UaLog.close()}catch(b){a=`send\n${b}`,xerror(a),alert(a),setOutText(a)}hideSpinner()}else alert("Ricorda di scrivere la Query  ")},async send2(){if(this.inp.value){showSpinner();ThreadMgr.isFirst()&&setOutText("");var a=this.inp.value.trim();try{const b=await Rag.requestContext(a);if(""==b){hideSpinner();return}setOutText(b);this.inp.value=""}catch(b){a=`send2\n${b}`,xerror(a),
+alert(a),setOutText(a)}hideSpinner()}else alert("Ricorda di scrivere la Query  ")},clear(){confirm("Confermi cancellazione conversazione? ")&&(this.inp.value="",setOutText(""),ThreadMgr.init())}},setOutText=a=>{var b=document.getElementById("id-text-out");b.innerHTML='<pre class="pre-text"></pre>';b=b.querySelector(".pre-text");b.textContent=a;b.scrollTop=b.scrollHeight};
+TextOutput={init(){this.copyBtn=document.querySelector(".copy-output");this.copyBtn.addEventListener("click",()=>this.copy());document.querySelector(".clear-output").addEventListener("click",()=>this.clear());document.querySelector(".wnd-output").addEventListener("click",()=>this.openWnd())},openWnd(){const a=document.getElementById("id-text-out").textContent;wnds.wout.show(a)},async copy(){const a=document.getElementById("id-text-out").querySelector("pre");if(a){var b=a.textContent;a.classList.add("copied");
+this.copyBtn.classList.add("copied");try{await navigator.clipboard.writeText(b)}catch(c){xerror("Errore  ",c)}setTimeout(()=>{this.copyBtn.classList.remove("copied");a.classList.remove("copied")},5E3)}},clear(){document.getElementById("id-text-out").textContent=""}};const RagUpload={open(){const a=UaWindowAdm.create("id_upload");a.drag();a.setZ(12);a.vw_vh().setXY(16.5,10,-1);a.setHtml('\n      <div class="window-text">\n        <div class="btn-wrapper">\n          <button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>\n        </div>     \n        <div class="upload">     \n          <h4>Upload file Text / PDF</h4>    \n          <form id="uploadForm">\n              <input class="file" type="file" id="id_fileupload" >   \n              <button type="button" onclick="RagUpload.upload();">Upload and Convert</button>\n          </form>\n          <div id="result" class="result"></div>\n        </div>\n      </div>\n    ');
+a.show()},async upload(){const a=document.getElementById("id_fileupload").files[0];if(a){var b=a.name;if(DataMgr.doc_names.includes(b))alert("Il file \u00e8 gi\u00e0 in archivio");else{var c=document.getElementById("result"),d=a.name.split(".").pop().toLowerCase();showSpinner();try{let e;if("pdf"===d){const f=new PdfHandler;await f.loadPdfJs();e=await f.extractTextFromPDF(a);f.cleanup()}else if("txt"===d)e=await readTextFile(a);else{alert("Formato file non supportato.");return}DataMgr.addDoc(b,e);
+c.innerHTML=`<br><br> ${b}<br><br>caricato e salvato nella memoria locale`}catch(e){console.error("Error:",e),alert("Errore durante l'estrazione del testo dal file.")}finally{hideSpinner()}}}else alert("Nessun file selezionato.")},openDir(){const a=UaWindowAdm.create("id_upload");a.drag();a.setZ(12);a.vw_vh().setXY(16.5,10,-1);a.setHtml('\n      <div class="window-text">\n        <div class="btn-wrapper">\n          <button class="btn-close" title="chiudi" onclick="UaWindowAdm.closeThis(this)">X</button>\n        </div>     \n        <div class="upload">     \n          <h4>Upload files Text / PDF</h4>    \n          <form id="uploadForm">\n              <input id="id_fileupload" class="file" type="file"  webkitdirectory mozdirectory msdirectory odirectory directory multiple />\n              <button type="button" onclick="RagUpload.uploadDir();">Upload and Convert</button>\n          </form>\n          <div class="result" id="result"></div>\n        </div>\n      </div>\n    ');
+a.show()},async uploadDir(){var a=document.getElementById("id_fileupload").files;if(a&&0!=a.length){var b=[];showSpinner();try{for(const c of a){const d=c.name;UaLog.log_show(d);if(DataMgr.doc_names.includes(d)){UaLog.log_shw(d+" : \u00e8 gi\u00e0 in archivio");continue}const e=c.name.split(".").pop().toLowerCase();let f;if("pdf"===e){const h=new PdfHandler;await h.loadPdfJs();f=await h.extractTextFromPDF(c);h.cleanup()}else if("txt"===e)f=await readTextFile(c);else{alert("Formato file non supportato.");
+return}DataMgr.addDoc(d,f);b.push(`${d}`)}}catch(c){console.error("Error:",c),alert("Errore durante l'estrazione del testo dal file.")}finally{hideSpinner()}a=document.getElementById("result");b=b.join("<br>");a.innerHTML=b}else alert("Nessun file selezionato.")}};
+class PdfHandler{constructor(){this.workerScriptElement=this.scriptElement=this.pdfjsLib=null}async loadPdfJs(){window.pdfjsLib||(this.scriptElement=document.createElement("script"),this.scriptElement.src="https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.min.js",document.body.appendChild(this.scriptElement),await new Promise(a=>{this.scriptElement.onload=()=>{this.workerScriptElement=document.createElement("script");this.workerScriptElement.src="https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.worker.min.js";
+document.body.appendChild(this.workerScriptElement);this.workerScriptElement.onload=a}}));this.pdfjsLib=window["pdfjs-dist/build/pdf"];this.pdfjsLib.GlobalWorkerOptions.workerSrc="https://cdnjs.cloudflare.com/ajax/libs/pdf.js/2.6.347/pdf.worker.min.js"}async extractTextFromPDF(a){a=await a.arrayBuffer();a=await this.pdfjsLib.getDocument({data:a}).promise;let b="";for(let c=1;c<=a.numPages;c++){const d=(await (await a.getPage(c)).getTextContent()).items.map(e=>e.str).join(" ");b+=d+"\n"}return b}cleanup(){this.scriptElement&&
+(document.body.removeChild(this.scriptElement),this.scriptElement=null);this.workerScriptElement&&(document.body.removeChild(this.workerScriptElement),this.workerScriptElement=null);this.pdfjsLib=null;window.gc&&window.gc()}}
+async function readTextFile(a){if(!a||"text/plain"!==a.type)throw Error("Invalid file type. Please select a text file.");return new Promise((b,c)=>{const d=new FileReader;d.onload=e=>b(e.target.result);d.onerror=e=>c(Error("Error reading file: "+e.message));d.readAsText(a)})};const nodrag_tds=["input","select","a"],nodrag_cls="nodrag";
+var UaDrag=function(a){return function(b){let c=0,d=0,e=0,f=0;const h=function(g){g=g||window.event;g.preventDefault();c=e-g.clientX;d=f-g.clientY;e=g.clientX;f=g.clientY;b.style.top=b.offsetTop-d+"px";b.style.left=b.offsetLeft-c+"px"},l=function(){document.onmouseup=null;document.onmousemove=null};b.onmousedown=function(g){g=g||window.event;let k=g.target;!(k=k||null)||nodrag_tds.includes(k.tagName.toLowerCase())||k.classList.contains(nodrag_cls)||(g.preventDefault(),e=g.clientX,f=g.clientY,document.onmouseup=
+l,document.onmousemove=h)}}(a)};const UaJtfh=()=>({rows:[],init(){this.rows=[];return this},insert(a){this.rows.unshift(a);return this},append(a){this.rows.push(a);return this},text(a=""){return this.rows.join(a)},html(a=""){return this.rows.join(a).replace(/\s+|\[rn\]/g," ")}});var UaLog={callHide:function(){},callShow:function(){},active:!1,wind:null,x:null,y:null,z:null,max_length:2E3,msg_id:"ualogmsg_",new:function(){null==this.wind&&(this.wind=UaWindowAdm.create("ualog_"),this.wind.drag());this.wind.setHtml('\n         <button type="button" onclick="javascript:UaLog.cls();">Clear</button>\n         <button type="button" onclick="javascript:UaLog.close();">Close</button>\n         <div id="ualogmsg_"></div>');this.wind.setStyle({width:"auto",minWidth:"300px",maxWidth:"400px",
+height:"auto",textAlign:"center",padding:"2px 2px 2px 2px",margin:"5px 0 0 0",background:"#333333",color:"#ffffff",fontSize:"15px",fontWeight:"normal",borderRadius:"9px",border:"1px solid #999999"});var a=document.getElementById(this.msg_id);const b={width:"auto",textAlign:"left",fontSize:"16px",fontFamily:"monospace",paddingTop:"2px ",marginTop:"2px",color:"inherit",background:"#000000",maxHeight:"600px",overflow:"auto",scrollbarColor:"#ab3205 #ffffff",scrollbarWidth:"auto"};for(const d in b)a.style[d]=
+b[d];const c={background:"#444444",color:"#ffffff",padding:"5px 5px 5px 5px",margin:"0 5px 0 5px",fontSize:"16px",fontWeight:"bold",border:"1px solid #ffffff",borderRadius:"10px"};a=document.querySelectorAll("#ualog_  button");for(const d of a){for(const e in c)d.style[e]=c[e];d.addEventListener("mouseover",e=>{e.target.style.cursor="pointer";e.target.style.color="#000000";e.target.style.background="#aaaaaa"});d.addEventListener("mouseout",e=>{for(const f in c)e.target.style[f]=c[f]})}this.x?this.wind.vw_vh().setXY(this.x,
+this.y,-1):this.wind.setCenter(-1);this.z&&this.wind.setZ(this.z);return this},setXY(a,b){this.x=a;this.y=b;return this},setZ(a){this.z=a;return this},prn_(...a){var b=a.join("<br/>");a=document.getElementById(this.msg_id);b=a.innerHTML+b+"<br/>";b.length>this.max_length&&(b=b.slice(-this.max_length));a.innerHTML=b},print(...a){null!=this.wind&&this.active&&this.prn_(...a)},log(...a){null!=this.wind&&this.prn_(...a)},log_show(...a){null!=this.wind&&(this.active||this.toggle(),this.prn_(...a))},cls(){if(null!=
+this.wind)return document.getElementById(this.msg_id).innerHTML="",this},close(){null!=this.wind&&(this.wind.hide(),this.active=!1,this.callHide())},toggle(){null!=this.wind&&(this.active?(this.active=!1,this.wind.hide(),this.callHide()):(this.active=!0,this.wind.show(),this.callShow()))}};var UaWindowAdm={ws:{},create(a,b=null){let c=document.getElementById(a);c||(c=document.createElement("div"),b?document.getElementById(b).appendChild(c):document.body.appendChild(c),c.id=a,c.setAttribute("data-name","ua-window"),b=this.newUaWindow(c),this.ws[a]=b);a=this.ws[a];c.style.display="none";return a},get(a){return this.ws[a]?this.ws[a]:null},show(a){this.ws[a]&&this.ws[a].show()},close(a){this.ws[a]&&this.ws[a].close()},toggle(a){this.ws[a]&&this.ws[a].toggle()},hide(a){this.ws[a]&&this.ws[a].hide()},
+closeThis(a){a=a.closest('[data-name="ua-window"]').id;this.ws[a].close()},showAll(){for(let a in this.ws)this.ws[a].show()},hideAll(){for(let a in this.ws)this.ws[a].hide()},closeAll(){for(let a in this.ws)this.ws[a].close()},remove(a){this.ws[a]&&(document.getElementById(a).remove(),this.ws[a]=null,delete this.ws[a])},removeAll(){for(let a in this.ws)this.remove(a);this.ws={}},newUaWindow(a){let b={initialize(c){this.w=c;this.wy=this.wx="0px";this.isVisible=this.isOpen=!1;this.firstShow=!0;this.wz=
+this.pos=0;this.vh=this.vw="px"},vw_vh(){this.vw="vw";this.vh="vh";return this},addClassStyle(c){this.w.classList.contains(c)||this.w.classList.add(c);return this},removeClassStyle(c){this.w.classList.contains(c)&&this.w.classList.remove(c);return this},getWindow(){alert("getWindow => ??");return this.w},getElement(){return this.w},getId(){return this.w.id},setStyle(c){for(const d in c)this.w.style[d]=c[d];return this},setHtml(c){this.w.innerHTML=c;return this},getHtml(){return this.w.innerHTML},
+setXY(c,d,e=0){this.wx=c;this.wy=d;this.pos=e;return this},setCenterY(c,d){this.setXY((window.innerWidth-this.w.clientWidth)/2,c,d);return this},setCenter(c){this.setXY((window.innerWidth-this.w.clientWidth)/2,(window.innerHeight-this.w.clientHeight)/2,c);return this},linkToId(c,d,e,f){c=document.getElementById(c);this.linkToElement(c,d,e,f);return this},linkToElement(c,d,e,f){d=c.offsetLeft+c.offsetWidth+d;c=c.offsetTop+e;0>c&&(c=0);this.setXY(d,c,f);return this},setZ(c){this.wz=c;return this},reset(){this.firstShow=
+!0;return this},toggle(){this.isVisible?this.hide():this.show();return this},show(){if(this.firstShow||1==this.pos||0===this.pos&&!1===this.isVisible)this.w.style.position="absolute",this.w.style.marginLeft=0,this.w.style.marginTop=0,this.w.style.top=`${this.wy}${this.vh}`,0<=this.wx?this.w.style.left=`${this.wx}${this.vw}`:this.w.style.right=-`${this.wx}${this.vw}`,0<this.wz&&(this.w.style.zIndex=this.wz);this.w.style.display="";this.firstShow=!1;this.isOpen=this.isVisible=!0;return this},hide(){this.w.style.display=
+"none";this.isVisible=!1;return this},close(){this.w.style.display="none";this.w.innerHTML="";this.isOpen=!1;return this},remove(){UaWindowAdm.remove(this.w.id);return null},drag(){UaDrag(this.w);return this}};b.initialize(a);return b}};

static/less/normalize.css

@@ -0,0 +1,352 @@
+/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
+
+/* Document
+   ========================================================================== */
+
+/**
+ * 1. Correct the line height in all browsers.
+ * 2. Prevent adjustments of font size after orientation changes in iOS.
+ */
+
+html {
+  line-height: 1.15; /* 1 */
+  /*
+  -webkit-text-size-adjust: 100%;
+  */
+   /* 2 */
+}
+
+/* Sections
+   ========================================================================== */
+
+/**
+ * Remove the margin in all browsers.
+ */
+
+body {
+  margin: 0;
+}
+
+/**
+ * Render the `main` element consistently in IE.
+ */
+
+main {
+  display: block;
+}
+
+/**
+ * Correct the font size and margin on `h1` elements within `section` and
+ * `article` contexts in Chrome, Firefox, and Safari.
+ */
+
+h1 {
+  font-size: 2em;
+  margin: 0.67em 0;
+}
+
+/* Grouping content
+   ========================================================================== */
+
+/**
+ * 1. Add the correct box sizing in Firefox.
+ * 2. Show the overflow in Edge and IE.
+ */
+
+hr {
+  box-sizing: content-box; /* 1 */
+  height: 0; /* 1 */
+  overflow: visible; /* 2 */
+}
+
+/**
+ * 1. Correct the inheritance and scaling of font size in all browsers.
+ * 2. Correct the odd `em` font sizing in all browsers.
+ */
+
+pre {
+  font-family: monospace, monospace; /* 1 */
+  font-size: 1em; /* 2 */
+}
+
+/* Text-level semantics
+   ========================================================================== */
+
+/**
+ * Remove the gray background on active links in IE 10.
+ */
+
+a {
+  background-color: transparent;
+}
+
+/**
+ * 1. Remove the bottom border in Chrome 57-
+ * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.
+ */
+
+abbr[title] {
+  border-bottom: none; /* 1 */
+  text-decoration: underline; /* 2 */
+  text-decoration: underline dotted; /* 2 */
+}
+
+/**
+ * Add the correct font weight in Chrome, Edge, and Safari.
+ */
+
+b,
+strong {
+  font-weight: bolder;
+}
+
+/**
+ * 1. Correct the inheritance and scaling of font size in all browsers.
+ * 2. Correct the odd `em` font sizing in all browsers.
+ */
+
+code,
+kbd,
+samp {
+  font-family: monospace, monospace; /* 1 */
+  font-size: 1em; /* 2 */
+}
+
+/**
+ * Add the correct font size in all browsers.
+ */
+
+small {
+  font-size: 80%;
+}
+
+/**
+ * Prevent `sub` and `sup` elements from affecting the line height in
+ * all browsers.
+ */
+
+sub,
+sup {
+  font-size: 75%;
+  line-height: 0;
+  position: relative;
+  vertical-align: baseline;
+}
+
+sub {
+  bottom: -0.25em;
+}
+
+sup {
+  top: -0.5em;
+}
+
+/* Embedded content
+   ========================================================================== */
+
+/**
+ * Remove the border on images inside links in IE 10.
+ */
+
+img {
+  border-style: none;
+}
+
+/* Forms
+   ========================================================================== */
+
+/**
+ * 1. Change the font styles in all browsers.
+ * 2. Remove the margin in Firefox and Safari.
+ */
+
+button,
+input,
+optgroup,
+select,
+textarea {
+  font-family: inherit; /* 1 */
+  font-size: 100%; /* 1 */
+  line-height: 1.15; /* 1 */
+  margin: 0; /* 2 */
+}
+
+/**
+ * Show the overflow in IE.
+ * 1. Show the overflow in Edge.
+ */
+
+button,
+input { /* 1 */
+  overflow: visible;
+}
+
+/**
+ * Remove the inheritance of text transform in Edge, Firefox, and IE.
+ * 1. Remove the inheritance of text transform in Firefox.
+ */
+
+button,
+select { /* 1 */
+  text-transform: none;
+}
+
+/**
+ * Correct the inability to style clickable types in iOS and Safari.
+ */
+
+button,
+[type="button"],
+[type="reset"],
+[type="submit"] {
+  -webkit-appearance: button;
+}
+
+/**
+ * Remove the inner border and padding in Firefox.
+ */
+
+button::-moz-focus-inner,
+[type="button"]::-moz-focus-inner,
+[type="reset"]::-moz-focus-inner,
+[type="submit"]::-moz-focus-inner {
+  border-style: none;
+  padding: 0;
+}
+
+/**
+ * Restore the focus styles unset by the previous rule.
+ */
+
+button:-moz-focusring,
+[type="button"]:-moz-focusring,
+[type="reset"]:-moz-focusring,
+[type="submit"]:-moz-focusring {
+  outline: 1px dotted ButtonText;
+}
+
+/**
+ * Correct the padding in Firefox.
+ */
+
+fieldset {
+  padding: 0.35em 0.75em 0.625em;
+}
+
+/**
+ * 1. Correct the text wrapping in Edge and IE.
+ * 2. Correct the color inheritance from `fieldset` elements in IE.
+ * 3. Remove the padding so developers are not caught out when they zero out
+ *    `fieldset` elements in all browsers.
+ */
+
+legend {
+  box-sizing: border-box; /* 1 */
+  color: inherit; /* 2 */
+  display: table; /* 1 */
+  max-width: 100%; /* 1 */
+  padding: 0; /* 3 */
+  white-space: normal; /* 1 */
+}
+
+/**
+ * Add the correct vertical alignment in Chrome, Firefox, and Opera.
+ */
+
+progress {
+  vertical-align: baseline;
+}
+
+/**
+ * Remove the default vertical scrollbar in IE 10+.
+ */
+
+textarea {
+  overflow: auto;
+}
+
+/**
+ * 1. Add the correct box sizing in IE 10.
+ * 2. Remove the padding in IE 10.
+ */
+
+[type="checkbox"],
+[type="radio"] {
+  box-sizing: border-box; /* 1 */
+  padding: 0; /* 2 */
+}
+
+/**
+ * Correct the cursor style of increment and decrement buttons in Chrome.
+ */
+
+[type="number"]::-webkit-inner-spin-button,
+[type="number"]::-webkit-outer-spin-button {
+  height: auto;
+}
+
+/**
+ * 1. Correct the odd appearance in Chrome and Safari.
+ * 2. Correct the outline style in Safari.
+ */
+
+[type="search"] {
+  -webkit-appearance: textfield; /* 1 */
+  outline-offset: -2px; /* 2 */
+}
+
+/**
+ * Remove the inner padding in Chrome and Safari on macOS.
+ */
+
+[type="search"]::-webkit-search-decoration {
+  -webkit-appearance: none;
+}
+
+/**
+ * 1. Correct the inability to style clickable types in iOS and Safari.
+ * 2. Change font properties to `inherit` in Safari.
+ */
+
+::-webkit-file-upload-button {
+  -webkit-appearance: button; /* 1 */
+  font: inherit; /* 2 */
+}
+
+/* Interactive
+   ========================================================================== */
+
+/*
+ * Add the correct display in Edge, IE 10+, and Firefox.
+ */
+
+details {
+  display: block;
+}
+
+/*
+ * Add the correct display in all browsers.
+ */
+
+summary {
+  display: list-item;
+}
+
+/* Misc
+   ========================================================================== */
+
+/**
+ * Add the correct display in IE 10+.
+ */
+
+template {
+  display: none;
+}
+
+/**
+ * Add the correct display in IE 10.
+ */
+
+[hidden] {
+  display: none;
+}

static/less/ragrqs.less

@@ -0,0 +1,991 @@
+/** @format */
+
+html,
+body,
+div,
+span,
+table,
+td,
+label,
+p,
+a,
+input,
+ul,
+li,
+button {
+  padding: 0;
+  margin: 0;
+  font-family: @fsans;
+}
+
+.bb0 {
+  background: #daee59 !important;
+}
+.bb1 {
+  background: #5487fc !important;
+}
+
+html {
+  background: @contaniner-bg;
+}
+body {
+  background: @contaniner-bg;
+  box-sizing: border-box;
+  min-height: 100vh;
+  height: 100vh;
+  position: relative;
+  padding: 0;
+  margin: 0;
+  overflow: hidden;
+  font-family: @fsans;
+  font-weight: normal;
+}
+
+// spinner
+.spinner {
+  z-index: 1000;
+  position: absolute;
+  top: 70vh;
+  left: 50vw;
+  transform: translate(-50%, -50%);
+  cursor: pointer;
+  display: none;
+  align-items: center;
+
+  .pulse-icon {
+    width: 20px;
+    height: 20px;
+    background-color: #ff8c00; // Arancione
+    border-radius: 50%;
+    animation: pulse 1.5s ease-in-out infinite;
+  }
+
+  .stop-message {
+    margin-left: 15px;
+    background-color: inherit;
+    color: #8f8a8a;
+    padding: 8px 15px;
+    border-radius: 10px;
+    font-size: 22px;
+    font-weight: bold;
+    opacity: 1;
+    transition: opacity 0.3s;
+  }
+
+  &:hover .stop-message {
+    color: @text-color;
+    background: @btn-hover;
+    opacity: 1;
+  }
+}
+
+@keyframes pulse {
+  0% {
+    transform: scale(0.6);
+    box-shadow: 0 0 0 0 rgba(255, 140, 0, 0.7); // Arancione con opacità
+  }
+
+  70% {
+    transform: scale(1.4);
+    box-shadow: 0 0 0 20px rgba(255, 140, 0, 0); // Arancione completamente trasparente
+  }
+
+  100% {
+    transform: scale(0.6);
+    box-shadow: 0 0 0 0 rgba(255, 140, 0, 0); // Arancione completamente trasparente
+  }
+}
+
+.show-spinner {
+  display: flex;
+}
+///////////////
+.upload {
+  @primary-color: darken(@color2, 25%);
+  @background-color: #121212;
+  @surface-color: #1e1e1e;
+  @btn-text-color: #000000;
+  @border-radius: 4px;
+
+  background-color: @surface-color;
+  padding: 2em;
+  padding-top: 0;
+  margin: 0;
+  border-radius: @border-radius;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.5);
+  text-align: center;
+
+  h4 {
+    color: @text-color;
+    margin-bottom: 1em;
+  }
+
+  form {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+
+    .file {
+      background-color: @background-color;
+      border: 1px solid lighten(@surface-color, 20%);
+      color: @text-color;
+      padding: 0.5em;
+      margin-bottom: 1em;
+      border-radius: @border-radius;
+      width: 100%;
+      box-sizing: border-box;
+
+      &::file-selector-button {
+        background-color: @primary-color;
+        color: @text-color;
+        // color: #000000;
+        border: none;
+        padding: 0.5em 1em;
+        border-radius: @border-radius;
+        cursor: pointer;
+
+        &:hover {
+          background-color: darken(@primary-color, 10%);
+        }
+      }
+    }
+
+    button {
+      background-color: @primary-color;
+      color: @text-color;
+      border: none;
+      padding: 0.5em 1em;
+      border-radius: @border-radius;
+      cursor: pointer;
+      width: 100%;
+      box-sizing: border-box;
+
+      &:hover {
+        background-color: darken(@primary-color, 10%);
+      }
+    }
+  }
+
+  .result {
+    width: 100%;
+    background: @output-bg;
+    color: @text-color;
+    font-size: @fsize-result;
+    font-weight: normal;
+    text-align: left;
+  }
+}
+
+@fserif: Georigia, "Ties New Roman", serif;
+@fsans: arial, verdana, Helvetica, sans-serif;
+
+// @fsize-menu: calc(10px + 1vw);
+@fsize-out: 20px;
+@fsize-inp: 20px;
+@fsize-help: 18px;
+@fsize-btn-close: 22px;
+@fsize-result: 15px;
+
+@base-bg: #000000;
+@text-color: #fff;
+@color1: #ff4500;
+@color2: #17d2ad;
+@color3: #e3d50e;
+
+@contaniner-bg: lighten(@base-bg, 10%);
+@border-shadow: lighten(@contaniner-bg, 20%);
+
+@btn-bg: lighten(@contaniner-bg, 10%);
+@btn-hover: lighten(@btn-bg, 15%);
+@btn-color: darken(@text-color, 10%);
+@btn-hover-fg: lighten(@color2, 10%);
+
+@border-hover: @color2;
+@border-input: @color1;
+// window
+@wnd-bg: lighten(@base-bg, 10%);
+@wnd-border-shadow: darken(@color3, 10%);
+@wnd-pre-color: lighten(@color3, 30%);
+//output
+@output-bg: darken(@contaniner-bg, 15%);
+@btn-copied: darken(@color2, 20%);
+@text-copied-bg: lighten(@output-bg, 5%);
+@text-copied: lighten(@color2, 20%);
+@input-bg: darken(@contaniner-bg, 15%);
+
+@btn-send-bg: darken(@color1, 20%);
+@btn-send-fg: @text-color;
+@btn-send-hover-bg: lighten(@btn-send-bg, 20%);
+
+@btn-send2-bg: darken(@color2, 20%);
+@btn-send2-hover-bg: lighten(@btn-send2-bg, 15%);
+
+div.container {
+  background: @contaniner-bg;
+  box-sizing: border-box;
+  position: relative;
+  top: 5vh;
+  left: 0;
+  height: 95vh;
+  margin: 0;
+  padding: 0;
+  transition: margin-left 0.5s ease;
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-start;
+  align-items: stretch;
+  flex-wrap: nowrap;
+  overflow-y: auto;
+  overflow-x: auto;
+
+  div.item {
+    box-sizing: border-box;
+    min-height: 50px;
+    margin: 0;
+    padding: 0;
+  }
+
+  div.item1 {
+    flex: 5;
+    padding-top: 0.5vh;
+    padding-right: 0.5vw;
+    padding-left: 0.5vw;
+    padding-bottom: 10vh;
+
+    .output-wrapper {
+      background-color: @contaniner-bg;
+      border-radius: 20px;
+      position: relative;
+      bottom: 0;
+      right: 0;
+      left: 0;
+      width: 100%;
+      height: 100%;
+      display: flex;
+      flex-direction: row;
+      align-items: flex-start;
+
+      .text-out {
+        flex: 1;
+        box-sizing: border-box;
+        background: @output-bg;
+        color: @text-color;
+        border: none;
+        padding: 2px;
+        min-width: 50vw;
+        height: 100%;
+        border-radius: 10px;
+        overflow-y: auto;
+        outline: none;
+        box-shadow: 0 0 0 2px @border-shadow;
+        &:hover {
+          box-shadow: 0 0 0 2px @border-hover;
+        }
+
+        .pre-text {
+          white-space: pre-wrap;
+          word-wrap: break-word;
+          font-family: @fsans;
+          font-size: @fsize-out;
+          line-height: 1.6;
+          padding: 2px;
+          margin: 0;
+          height: 100%;
+          box-sizing: border-box;
+          overflow-y: scroll;
+          scroll-behavior: smooth;
+          &.copied {
+            background-color: @text-copied-bg;
+            color: @text-copied;
+          }
+        }
+        .div-text {
+          white-space: pre-wrap;
+          word-wrap: break-word;
+          font-family: @fsans;
+          font-size: @fsize-out;
+          line-height: 1.6;
+          padding: 2px;
+          margin: 0;
+          height: 100%;
+          box-sizing: border-box;
+          overflow-y: scroll;
+        }
+        &.copied {
+          background-color: @text-copied-bg;
+          color: @text-copied;
+        }
+      }
+    }
+
+    .output-actions {
+      display: flex;
+      flex-direction: column;
+      align-items: flex-end;
+      margin-left: 0.5vw;
+      margin-right: 0.5vw;
+
+      .copy-output,
+      .wnd-output,
+      .clear-output {
+        box-sizing: border-box;
+        background-color: @btn-bg;
+        color: @text-color;
+        border: none;
+        padding: 10px;
+        cursor: pointer;
+        border-radius: 50%;
+        width: 40px;
+        height: 40px;
+        display: flex;
+        align-items: center;
+        margin-bottom: 5px;
+        transition: background-color 0.3s;
+
+        &:hover {
+          background-color: @btn-hover;
+        }
+      }
+
+      .copy-output {
+        transition: background-color 0.3s, transform 0.3s;
+
+        &.copied {
+          background: @btn-hover-fg;
+          transform: scale(1.2);
+        }
+        .copy-icon {
+          fill: @text-color;
+          width: 24px;
+          height: 24px;
+
+          &:hover {
+            fill: @btn-hover-fg;
+          }
+        }
+      }
+      .clear-output,
+      .wnd-output {
+        transition: background-color 0.3s, transform 0.3s;
+        .icon {
+          fill: @text-color;
+          width: 24px;
+          height: 24px;
+
+          &:hover {
+            fill: @btn-hover-fg;
+          }
+        }
+      }
+    }
+  }
+}
+
+////////////////////
+*:hover {
+  outline: none;
+  caret-color: transparent;
+}
+
+textarea:focus {
+  caret-color: auto;
+}
+
+///////////////////
+
+div.item2 {
+  flex: 2;
+  padding-top: 0;
+  padding-bottom: 0;
+  padding-right: 0.5vw;
+  padding-left: 0.5vw;
+
+  .input-wrapper {
+    background-color: @contaniner-bg;
+    border-radius: 20px;
+    position: relative;
+    bottom: 2vh;
+    right: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    display: flex;
+    flex-direction: row;
+    align-items: flex-start;
+
+    &:focus-within .clear-button {
+      display: block;
+    }
+
+    .text-input {
+      flex: 1;
+      font-size: @fsize-inp;
+      font-family: @fsans;
+      resize: none;
+      box-sizing: border-box;
+      background: @input-bg;
+      color: @text-color;
+      border: none;
+      padding: 2px;
+      padding-right: 40px;
+      height: 100%;
+      margin-left: 5px;
+      border-radius: 10px;
+      overflow-y: auto;
+      outline: none;
+      box-shadow: 0 0 0 2px @border-shadow;
+      &:hover {
+        box-shadow: 0 0 0 2px @border-hover;
+      }
+
+      &:focus {
+        box-shadow: 0 0 0 2px @border-input;
+      }
+    }
+
+    .clear-button {
+      position: absolute;
+      right: 60px;
+      top: 19vh;
+      padding: 5px;
+      border-radius: 50%;
+      background: @btn-bg;
+      border: none;
+      font-size: 20px;
+      cursor: pointer;
+      color: darken(@text-color, 20%);
+      display: none;
+      &:hover {
+        font-weight: bold;
+        background: @btn-hover;
+        color: @text-color;
+      }
+    }
+
+    .input-actions {
+      display: flex;
+      flex-direction: column;
+      margin-left: 0.5vw;
+      margin-right: 0.5vw;
+
+      .send-input,
+      .send2-input,
+      .clear-input {
+        box-sizing: border-box;
+        background-color: @btn-bg;
+        color: @text-color;
+        border: none;
+        padding: 10px;
+        cursor: pointer;
+        border-radius: 50%;
+        width: 40px;
+        height: 40px;
+        margin-bottom: 5px;
+        transition: background-color 0.3s;
+
+        &:hover {
+          background-color: @btn-hover;
+        }
+      }
+
+      .send-input {
+        background: @btn-send-bg;
+
+        &:hover {
+          background: @btn-send-hover-bg;
+        }
+      }
+
+      .send2-input {
+        background: @btn-send2-bg;
+
+        &:hover {
+          background: @btn-send2-hover-bg;
+        }
+      }
+
+      .clear-input {
+        background: @btn-bg;
+        color: @btn-color;
+        &:hover {
+          background: @btn-hover;
+          color: @btn-hover-fg;
+        }
+      }
+    }
+  }
+}
+
+// menu_h
+@fsize-upload: 20px;
+@fsize-log: 14px;
+@fsize-menu: 14px;
+
+@menu-width: 16vw;
+@menu-bg: darken(@contaniner-bg, 35%);
+@menu-border: lighten(@menu-bg, 20%);
+@menu-fg: @text-color;
+@menu-icon-fg: #aea7a7;
+@menu-icon-hover: lighten(@color2, 10%);
+
+.menu-open {
+  .container {
+    margin-left: @menu-width;
+  }
+
+  .menu-box {
+    left: 0 !important;
+  }
+}
+
+div.menu-h {
+  background-color: lighten(@menu-bg, 10%);
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 4.5vh;
+  padding: 0;
+  margin: 0;
+  outline: none;
+  box-shadow: 0 0 0 2px @border-shadow;
+  z-index: 100;
+  // caret-color: transparent;
+
+  .release {
+    background: inherit;
+    color: lighten(@color1, 10%);
+    font-weight: bold;
+    margin-left: 57vw;
+    margin-top: 0.5vh;
+  }
+  .menu-btn {
+    appearance: none;
+  }
+
+  .menu-btn:checked {
+    & + .menu-icon {
+      border: 1px solid @menu-border;
+
+      .nav-icon {
+        transform: rotate(45deg);
+
+        &::before {
+          top: 0;
+        }
+
+        &::after {
+          top: 0;
+          transform: rotate(90deg);
+        }
+      }
+    }
+  }
+
+  .menu-icon {
+    box-sizing: border-box;
+    background-color: inherit;
+    display: block;
+    position: absolute;
+    margin-left: 2vw;
+    top: 0;
+    left: 0;
+    width: 4vw;
+    height: 4.5vh;
+    cursor: pointer;
+    padding: 2px 2px;
+    z-index: 1;
+
+    &:hover {
+      .nav-icon,
+      .nav-icon::before,
+      .nav-icon::after {
+        background-color: @menu-icon-hover;
+      }
+    }
+
+    .nav-icon {
+      background-color: @menu-icon-fg;
+      display: block;
+      position: absolute;
+      top: 14px;
+      left: 0;
+      width: 25px;
+      height: 2px;
+      transition-duration: 0.25s;
+    }
+
+    .nav-icon::before,
+    .nav-icon::after {
+      content: "";
+      position: absolute;
+      left: 0;
+      background-color: inherit;
+      width: inherit;
+      height: inherit;
+    }
+
+    .nav-icon::before {
+      top: -8px;
+    }
+
+    .nav-icon::after {
+      top: 8px;
+    }
+  }
+
+  .head-wrapper {
+    position: absolute;
+    top: 0;
+    left: 5vw;
+    height: 4vh;
+    padding: 0;
+    margin: 0;
+    display: inline-flex;
+    flex-direction: row;
+    flex-wrap: nowrap;
+    align-items: center;
+    justify-content: flex-start;
+
+    .log,
+    .help,
+    .upload,
+    .upload-dir {
+      margin-top: 2px;
+      margin-left: 30px;
+      margin-right: 0;
+      padding: 5px 5px 0 5px;
+      border: none;
+      cursor: pointer;
+      border-radius: 20%;
+      font-size: @fsize-upload;
+      color: @text-color;
+      background: @btn-bg;
+      max-height: 4vh;
+
+      &:hover {
+        background: @btn-hover;
+      }
+    }
+  }
+
+  .upload,
+  .upload-dir {
+    transition: background-color 0.3s, transform 0.3s;
+    .icon {
+      fill: @text-color;
+      width: 24px;
+      height: 24px;
+
+      &:hover {
+        fill: @btn-hover-fg;
+      }
+    }
+  }
+
+  .log {
+    font-size: @fsize-log !important;
+    font-weight: normal !important;
+    background: darken(@color1, 20%) !important;
+    &:hover {
+      background: darken(@color1, 10%) !important;
+    }
+    &.active {
+      background: darken(@color2, 20%) !important;
+
+      &:hover {
+        background: darken(@color2, 10%) !important;
+      }
+    }
+  }
+
+  div.menu-box {
+    position: fixed;
+    top: 5vh;
+    left: -2000px;
+    height: 95vh;
+    width: @menu-width;
+    transition: left 0.3s ease-out;
+    padding: 0;
+    padding-top: 1vh;
+    padding-left: 0.5vw;
+    z-index: 101;
+    background: lighten(@menu-bg, 5%);
+    box-sizing: border-box;
+    outline: none;
+    box-shadow: 0 0 0 2px @border-shadow;
+    display: flex;
+    flex-direction: column;
+    flex-wrap: nowrap;
+    justify-content: flex-start;
+    align-items: stretch;
+    overflow-y: auto;
+    overflow-x: auto;
+
+    ul {
+      list-style: none;
+      margin: 0;
+      padding: 0;
+      display: flex;
+      flex-direction: column;
+      border-top: 1px solid @menu-border;
+
+      li {
+        border-left: 1px solid @menu-border;
+        border-right: 1px solid @menu-border;
+        border-bottom: 1px solid @menu-border;
+
+        a {
+          color: @menu-fg;
+          font-size: @fsize-menu;
+          font-family: @fsans;
+          font-weight: normal;
+          display: block;
+          margin: 0;
+          padding: 2px 2px 2px 0;
+          text-align: left;
+          text-decoration: none;
+        }
+
+        &:hover {
+          text-decoration: underline;
+          background-color: lighten(@menu-bg, 20%);
+          color: @menu-icon-hover;
+        }
+      }
+      a.delete {
+        text-align: center;
+        font-weight: bold;
+        font-style: italic;
+        color: #000000;
+        background: darken(@color3, 10%);
+      }
+      a.help {
+        text-align: center;
+        font-weight: bold;
+        font-style: italic;
+        color: #000000;
+        background: darken(@color1, 10%);
+      }
+
+      li.show {
+        background: @base-bg;
+        color: @text-color;
+        width: 100%;
+        text-align: center;
+        box-sizing: border-box;
+
+        &:hover {
+          text-decoration: none;
+        }
+      }
+    }
+  }
+}
+
+// Window
+.window-text {
+  position: relative;
+  top: 0;
+  left: 0;
+  background: @wnd-bg;
+  color: @text-color;
+  border: none;
+  padding: 0 2px 2px 2px;
+  width: 78vw;
+  height: 80vh;
+  border-radius: 10px;
+  box-sizing: border-box;
+  outline: none;
+  box-shadow: 0 0 0 2px @wnd-border-shadow;
+  overflow-y: auto;
+
+  pre.pre-text {
+    color: @wnd-pre-color;
+    white-space: pre-wrap;
+    word-wrap: break-word;
+    font-family: @fserif;
+    font-size: @fsize-help;
+    line-height: 1.6;
+    padding: 2px;
+    margin: 0;
+    text-align: left;
+  }
+
+  // help
+  div.text {
+    font-size: @fsize-help;
+    font-weight: normal;
+    padding-left: 10px;
+    padding-right: 10px;
+    margin: 0;
+    pre {
+      white-space: pre-wrap;
+      word-wrap: break-word;
+      font-family: @fsans;
+      font-size: @fsize-help;
+      line-height: 1.3;
+      padding: 0 5px 0 5px;
+      margin: 0;
+      text-align: left;
+    }
+    .center {
+      text-align: center;
+      font-size: @fsize-help;
+      font-weight: bold;
+      text-decoration: underline;
+      font-style: italic;
+      color: @color3;
+    }
+    div {
+      font-family: @fsans;
+      font-size: @fsize-help;
+      font-weight: bold;
+      padding-top: 0;
+      padding-bottom: 0;
+      a {
+        background: @base-bg;
+        color: @text-color;
+        font-weight: normal;
+        &:hover {
+          background: lighten(@base-bg, 20%);
+          color: @text-color;
+        }
+      }
+    }
+
+    p {
+      font-size: @fsize-help;
+      font-weight: normal;
+      font-family: @fsans;
+      text-align: justify;
+      padding-bottom: 9px;
+      padding-right: 0;
+      padding-left: 10px;
+    }
+  }
+}
+
+.btn-wrapper {
+  width: 100%;
+  height: 2vw;
+  position: sticky;
+  top: 0;
+  padding: 0;
+  background: lighten(@wnd-bg, 5%);
+
+  .btn-copy {
+    position: absolute;
+    top: 1px;
+    right: 5vw;
+    box-sizing: border-box;
+    background: inherit;
+    color: @text-color;
+    border: none;
+    cursor: pointer;
+    width: 30px;
+    margin: 0;
+    padding: 0;
+    transition: background-color 0.3s;
+
+    &:hover {
+      background-color: @btn-hover;
+    }
+
+    // &.copied {
+    //   background-color: @btn-copied;
+    //   transform: scale(1.2);
+    // }
+    .copy-icon {
+      fill: @btn-color;
+      width: 20px;
+      height: 20px;
+
+      &:hover {
+        fill: @btn-hover-fg;
+        background: lighten(@wnd-bg, 15%);
+      }
+    }
+  }
+
+  .btn-close {
+    position: absolute;
+    top: 0;
+    right: 2vw;
+    margin: 0;
+    background-color: transparent;
+    border: none;
+    color: @btn-color;
+    font-size: @fsize-btn-close;
+    font-weight: bold;
+    cursor: pointer;
+    outline: none;
+
+    &:hover {
+      color: @btn-hover-fg;
+      background: lighten(@wnd-bg, 15%);
+    }
+  }
+}
+
+//message
+@popup-bg-color: #222222;
+@popup-text-color: #ffeb3b;
+@popup-border-color: #ffeb3b;
+@popup-width: 300px;
+@popup-height: 100px;
+@font-size: 24px;
+@border-radius: 15px;
+
+.msg {
+  box-sizing: border-box;
+  position: fixed;
+  width: @popup-width;
+  height: @popup-height;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  background-color: @popup-bg-color; // Grigio scuro
+  color: @popup-text-color; // Giallo
+  border: 2px solid @popup-border-color; // Bordo giallo
+  border-radius: @border-radius;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-family: Arial, sans-serif;
+  font-size: @font-size;
+  font-weight: bold;
+  text-align: center;
+  z-index: 1000;
+  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2);
+}
+
+//////////////// alert
+@primary-color: #212121; // Dark primary color
+@secondary-color: #37474F; // Dark secondary color
+@text-color: #FFFFFF; // Text color
+@background-color: #303030; // Background color
+
+// Style the alert and confirm dialogs
+.alert, .confirm {
+  background-color: @background-color !important;
+  color: @text-color;
+  padding: 20px;
+  border-radius: 4px;
+  box-shadow: 0 2px 4px #00000033 !important;
+
+  // Style the buttons
+  .button {
+    background-color: @secondary-color !important;
+    color: @text-color;
+    border: none;
+    padding: 10px 20px;
+    border-radius: 4px;
+    cursor: pointer;
+    margin-top: 20px;
+
+    &:hover {
+      background-color: darken(@secondary-color, 10%);
+    }
+  }
+}

static/ragrqs.html

@@ -0,0 +1,131 @@
+<!DOCTYPE html>
+<html lang="it">
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="Author:M.Materni" />
+    <title>RagRqs</title>
+
+    <link rel="stylesheet" href="css/ragrqs.min.css" />
+    <script src="js/ragrqs.min.js"></script>
+
+  <body>
+    <div id="spinner" class="spinner">
+      <div class="pulse-icon"></div>
+      <div class="stop-message">Stop</div>
+    </div>
+
+    <div class="menu-h">
+
+      <input id="id-menu-btn" name="id-menu-btn" class="menu-btn" type="checkbox" />
+      <label for="id-menu-btn" class="menu-icon">
+        <span class="nav-icon"></span>
+      </label>
+
+      <div class="head-wrapper">
+
+        <button class="help" onclick="Menu.help();" title="Istruzioni">?</button>
+
+        <button class="upload" onclick="Menu.upload();" ; title="Upload files">
+          <svg class="icon" viewBox="0 0 24 24">
+            <path d="M20 15v2H4v-2H2v5h20v-5zM13 5V1h-2v4H7l5 5 5-5z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+          </svg>
+        </button>
+
+        <button class="upload" onclick="Menu.uploadDir();" ; title="Upload dir">
+          <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path d="M20 6h-8l-2-2H4C2.9 4 2 4.9 2 6v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2zm-8 7H8v2h4v-2zm6 0h-4v2h4v-2zm0-4H8v2h10V9z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+          </svg>
+        </button>
+
+        <button class="log active" id="id_log" onclick="Menu.log();" title="Log">Log</button>
+        <label class="release"></label>
+      </div>
+      <div class="menu-box">
+        <ul>
+          <li><a href="#" onCLick="op0(this);">README</a></li>
+          <li><a href="#" onCLick="op1(this);">Qurty</a></li>
+          <li><a href="#" onCLick="showRagResponse(this);">Risposta</a></li>
+          <li><a href="#" onCLick="op2(this);">Elenco Risposte</a></li>
+          <li><a href="#" onCLick="op3(this);">Contesto RAG</a></li>
+          <li><a href="#" onCLick="op4(this);">Dati archviati</a></li>
+          <li><a href="#" onCLick="op5(this);">Elenco Documenti</a></li>
+          <li><a href="#" onCLick="calcQuery();">Numero Query</a></li>
+          <li><a class="delete" href="#" onCLick="op7(this);">Cancella Dati</a></li>
+          <li>-</li>
+          <li><a class="help" href="#" onCLick="op8(this);">Cancella Documenti</a></li>
+          <li>-</li>
+          <li><a href="#" onCLick="help1(this);">Esempi di documenti</a></li>
+          <li><a href="#" onCLick="help2(this);">Esempi di domande</a></li>
+<!-- 
+          <li><a href="#" onCLick="op9(this);">prompts</a></li>
+          <li><a href="#" onCLick="op6(this);">Testo Documenti</a></li>
+ -->
+        </ul>
+      </div>
+    </div>
+
+    <div class="container">
+      <div class="item item1">
+        <div class="output-wrapper">
+
+          <div class="text-out" id="id-text-out">
+          </div>
+
+          <div class="output-actions">
+            <button class="copy-output" title="Copia">
+              <svg class="copy-icon" viewBox="0 0 20 24">
+                <path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
+              </svg>
+            </button>
+            <button class="wnd-output" title="Apri">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M10 9v6h4V9h5l-7-7-7 7h5zM5 19v2h14v-2H5z" />
+              </svg>
+            </button>
+            <button class="clear-output" title="Cancella">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M3 6h18v2H3V6zm2 3h14v12H5V9zm3-7h6v2H8V2z" />
+              </svg>
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <div class="item item2">
+        <div class="input-wrapper">
+
+          <textarea class="text-input" placeholder="Scrivi qui... " rows="2"></textarea>
+          <button class="clear-button" title="Cancella input">X</button>
+
+          <div class="input-actions">
+            <button class="send-input" title="Documenti=>RAG=>Conetso=>Query">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M2 21l21-9L2 3v7l15 2-15 2v7z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+              </svg>
+            </button>
+
+
+            <button class="send2-input" title="Contesto=>Query">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M2 21l21-9L2 3v7l15 2-15 2v7z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+              </svg>
+            </button>
+            <button class="clear-input" title="Cancella Conversazione">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M3 6h18v2H3V6zm2 3h14v12H5V9zm3-7h6v2H8V2z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+              </svg>
+            </button>
+
+          </div>
+        </div>
+      </div>
+
+    </div>
+  </body>
+
+</html>
+<script>
+  openApp();
+</script>

static/ragrqs_.html

@@ -0,0 +1,149 @@
+<!DOCTYPE html>
+<html lang="it">
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="Author:M.Materni" />
+    <title>RagRqs</title>
+
+    <!-- 
+    <link rel="stylesheet" href="css/ragrqs.min.css" />
+    <script src="js/ragrqs.min.js"></script>
+   -->
+    <link rel="stylesheet" href="less/normalize.css" />
+    <link rel="stylesheet/less" type="text/css" href="less/ragrqs.less" />
+    <script src="less/less.js"></script>
+
+    <script src="javascript/uadrag.js"></script>
+    <script src="javascript/uawindow.js"></script>
+    <script src="javascript/uajtfh.js"></script>
+    <script src="javascript/ualog.js"></script>
+    <script src="javascript/rag_cleaner.js"></script>
+    <script src="javascript/rag_data_mgr.js"></script>
+    <script src="javascript/rag_http.js"></script>
+    <script src="javascript/rag_mgr.js"></script>
+    <script src="javascript/rag_prompts.js"></script>
+    <script src="javascript/rag_rqs.js"></script>
+    <script src="javascript/rag_upload.js"></script>
+    <script src="javascript/rag_ui.js"></script>
+
+  <body>
+    <div id="spinner" class="spinner">
+      <div class="pulse-icon"></div>
+      <div class="stop-message">Stop</div>
+    </div>
+
+    <div class="menu-h">
+
+      <input id="id-menu-btn" name="id-menu-btn" class="menu-btn" type="checkbox" />
+      <label for="id-menu-btn" class="menu-icon">
+        <span class="nav-icon"></span>
+      </label>
+
+      <div class="head-wrapper">
+
+        <button class="help" onclick="Menu.help();" title="Istruzioni">?</button>
+
+        <button class="upload" onclick="Menu.upload();" ; title="Upload files">
+          <svg class="icon" viewBox="0 0 24 24">
+            <path d="M20 15v2H4v-2H2v5h20v-5zM13 5V1h-2v4H7l5 5 5-5z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+          </svg>
+        </button>
+
+        <button class="upload" onclick="Menu.uploadDir();" ; title="Upload dir">
+          <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path d="M20 6h-8l-2-2H4C2.9 4 2 4.9 2 6v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2zm-8 7H8v2h4v-2zm6 0h-4v2h4v-2zm0-4H8v2h10V9z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+          </svg>
+        </button>
+
+        <button class="log active" id="id_log" onclick="Menu.log();" title="Log">Log</button>
+        <label class="release"></label>
+      </div>
+      <div class="menu-box">
+        <ul>
+          <li><a href="#" onCLick="op0(this);">README</a></li>
+          <li><a href="#" onCLick="op1(this);">Qurty</a></li>
+          <li><a href="#" onCLick="showRagResponse(this);">Risposta</a></li>
+          <li><a href="#" onCLick="op2(this);">Elenco Risposte</a></li>
+          <li><a href="#" onCLick="op3(this);">Contesto RAG</a></li>
+          <li><a href="#" onCLick="op4(this);">Dati archviati</a></li>
+          <li><a href="#" onCLick="op5(this);">Elenco Documenti</a></li>
+          <li><a href="#" onCLick="calcQuery();">Numero Query</a></li>
+          <li><a class="delete" href="#" onCLick="op7(this);">Cancella Dati</a></li>
+          <li>-</li>
+          <li><a class="help" href="#" onCLick="op8(this);">Cancella Documenti</a></li>
+          <li>-</li>
+          <li><a href="#" onCLick="help1(this);">Esempi di documenti</a></li>
+          <li><a href="#" onCLick="help2(this);">Esempi di domande</a></li>
+
+          <li><a href="#" onCLick="op9(this);">prompts</a></li>
+          <li><a href="#" onCLick="op6(this);">Testo Documenti</a></li>
+
+        </ul>
+      </div>
+    </div>
+
+    <div class="container">
+      <div class="item item1">
+        <div class="output-wrapper">
+
+          <div class="text-out" id="id-text-out">
+          </div>
+
+          <div class="output-actions">
+            <button class="copy-output" title="Copia">
+              <svg class="copy-icon" viewBox="0 0 20 24">
+                <path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
+              </svg>
+            </button>
+            <button class="wnd-output" title="Apri">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M10 9v6h4V9h5l-7-7-7 7h5zM5 19v2h14v-2H5z" />
+              </svg>
+            </button>
+            <button class="clear-output" title="Cancella">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M3 6h18v2H3V6zm2 3h14v12H5V9zm3-7h6v2H8V2z" />
+              </svg>
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <div class="item item2">
+        <div class="input-wrapper">
+
+          <textarea class="text-input" placeholder="Scrivi qui... " rows="2"></textarea>
+          <button class="clear-button" title="Cancella input">X</button>
+
+          <div class="input-actions">
+            <button class="send-input" title="Documenti=>RAG=>Conetso=>Query">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M2 21l21-9L2 3v7l15 2-15 2v7z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+              </svg>
+            </button>
+
+
+            <button class="send2-input" title="Contesto=>Query">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M2 21l21-9L2 3v7l15 2-15 2v7z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+              </svg>
+            </button>
+            <button class="clear-input" title="Cancella Conversazione">
+              <svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+                <path d="M3 6h18v2H3V6zm2 3h14v12H5V9zm3-7h6v2H8V2z" fill="none" stroke="#FFFFFF" stroke-width="2" />
+              </svg>
+            </button>
+
+          </div>
+        </div>
+      </div>
+
+    </div>
+  </body>
+
+</html>
+<script>
+  openApp();
+</script>